I finally ended up deciding to javadoc EVERYTHING, even private stuff
Good call. I did exactly the same thing.
And a tip for everybody: look at the
Java source code (it is in a file called src.zip, in the installation directory of the JDK) to see how they documented it. For instance, looking at the java.net.URL class (done by James Gosling, the father of Java), we can see that even the private methods were documented. I think that the Java source code is the best source to inspire us on how to build the code.
Cheers, Roberto Perillo
SCJP, SCWCD, SCJD, SCBCD