I found correctly following the developer documentation (javadoc) is challenging.
I am using CheckStyle and Sun's DocCheck tool to check my documentation and comment in code. These tools report such things as "missing @see tag", "missing javadoc comment" for get/set methods.
I personally do not see a need to document get/set methods, provided that they have intention revealing names. I also do not see why I have to use @see tag in methods and package documentation, either.
However, I am not sure whether the examiner would run some tool and deduct points on documentation, depending on how many errors the tool reports. I would think that unfair, after all comment supposes to be minimal and efficient.
I just thought to ask you how much comment do you provide?
Thanks.
Yan