Javadoc is here to help. To understand what the code does and how it works? Right?
I don’t think so. I confuses the heck out of me in most cases.
When I look at code like
/** * Version number of signature. */ public static final String SIGNATURE_VERSION = "1"; I get the feeling that the javadoc is pretty pointless. Well, the damn String is named what it is, how does the Javadoc help me here?