A problem we're facing now with JG (i think 90% of the Java projects out there have this problem) is that we've got lots of methods which don't have javadoc. That's ok if your project doesn't require a good javadoc, but for JG this is important, specially now that we're gaining more users.
So i was thinking: "ok, let's add javadoc where it's needing." But, where do i start? Do i have to open each and every class, looking for methods which don't have javadocs? Err... boring.
Then i thought: "let me look for a tool that lists missing javadocs for me" - but i couldn't find any!! Maybe i didn't look at the right places? I don't know, but here's what i did:
I just took the source code of gjdoc, and made a few changes to make it list methods without javadoc. And i'm thinking about putting this list in the wiki, like this, so people can write javadoc collaboratively. How cool is that?
Jeff is even suggesting me we could have some sort of prize for the person who contributes more =) Just gotta think of some nice/reasonable prize...
