Javadoc Should Not Containing Implementation Details

Comments are great. Javadocs are comments but not necessarily all comments are javadoc worthy.

Do not do things like make excuses for implementations and such for all public members. Perhaps move "personal" comments into non-javadoc comment blocks within the method block.

This task isn't high priority right now, though; just something that should be done between now and the final product. Over time, we should be listing out these kinds of comments and listing it here.

No files, tests, or entry points are named. Review the public-member Javadocs and identify implementation-detail comments, then move personal implementation notes into ordinary comments where appropriate and document the resulting list of changes in this issue.

Scritto dal modello di indicizzazione a partire dal testo della issue.