I agree with the above about JavaDoc.

As someone who is relatively new to Java myself, I'm still learning about how powerful JavaDoc can be.

That said, I read somewhere (I forget where) that...