All new classes, methods, and fields should have JavaDoc comments

[novalis]

I'll be documenting this on the DevelopersGuide, but for posterity I wanted to make a ticket for this. On the 12/11 call, we all agreed that all new classes, methods, and fields should have JavaDoc comments explaining what they are. For fields with getters and setters, the documentation should go above the getter.

Much of the existing code is lacking such commenting. Moving forward, we should make an effort to document existing code, and ''all'' new code must be documented.

[novalis]

Updated the DevelopersGuide.

--nicholasbs

[novalis]

{{{
#!html

}}}
This ticket has been referenced in ticket #78:

''Yes, we've closed ticket #93 (setting our commenting policy) and it's been documented in the DevelopersGuide...''

--nicholasbs