aspose file tools*
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes Is it a great technique to reduce the documentation? Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login


Win a copy of Spring in Action this week in the Spring forum!
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "Is it a great technique to reduce the documentation?" Watch "Is it a great technique to reduce the documentation?" New topic
Author

Is it a great technique to reduce the documentation?

Maurizio Nagni
Ranch Hand

Joined: May 29, 2004
Posts: 75
ok...ok... it may seems a stupid note but according to the assignement
javadoc style comments must be used for each element of the public interface of each class

I understood correctly that this mean that doing a better analisys of the code to reduce the visibility of methods and setting them as much as possible to private improve the code but also reduce the documentation to write, right?
Mark Smyth
Ranch Hand

Joined: Feb 04, 2004
Posts: 288
Originally posted by Maurizio Nagni:

I understood correctly that this mean that doing a better analisys of the code to reduce the visibility of methods and setting them as much as possible to private improve the code but also reduce the documentation to write, right?


I think that it is a good programming practice (ie good encapsulation)to limit the number of public methods in a class to only those methods that clients will need to use the class effectively. As you point out this also has the benefit of reducing the number of javadoc comments that you would need to write. It would still be a good idea to comment all protected and private methods and variables, but regular coments would do fine for this purpose.


SCJP<br />SCJD
Maurizio Nagni
Ranch Hand

Joined: May 29, 2004
Posts: 75
yes... i agree that anyway is a good thing to have a proper style to code.... i hate when i do "ctrl-space" in my NetBeans and i discover that the most of the opensource code documentation is empty.... oh well... that's another point. Dot.
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: Is it a great technique to reduce the documentation?