我的观点和考虑到的地方几乎和他一样。但当我在javaeye论坛里表达这些观点时，别人反而觉得好笑！
Remember that documentation should serve to:
1.
Provide a contract for objects and methods. Test cases for an object are also valuable specifications, and documentation and test cases should be kept synchronized.
2.
Save developers the trouble of needing to read code before they use it. There should be no need to examine a class’s code to establish what it does or whether it works. Javadoc exists to establish what it does, and unit tests should establish that it works as documented.
3.
Explain non-obvious features of the implementation. Deciding what is obvious is a tricky issue. Assume that your readers are competent Java and J2EE developers (unless you know otherwise, for example if you are writing a demonstration application for a new deployment).