Liferay is open source but if you look at the sources they are not significant better to read than any JAD output.
In my recent projects I found it very useful to activate Eclipse's Javadoc checks to recognize undocumented classes and methods. It also helps to update the Javadoc tags after some refactoring actions.
Even if I ignore the original Liferay sources, the service builder generates sources without method-Javadoc, so I get a lot of warnings from Eclipse if I switch on the Javadoc checks there in my own project.
Regards,
Roland
