learn java
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes Documentation Comments (scjd) Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login

Win a copy of The Software Craftsman this week in the Agile forum!
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "Documentation Comments (scjd)" Watch "Documentation Comments (scjd)" New topic

Documentation Comments (scjd)

Zakaria Haque
Ranch Hand

Joined: Jan 02, 2002
Posts: 60
Hi guys, I am little confused about how much javadoc style comment should we use. I have the following statements in my instructions
1. "javadoc style comments must be used for each element of the public interface of each class"
2. "You must provide HTML/Javadoc documentation for all classes, whether supplied, modified, or new"

Does that mean we can spare the non-public api from javadoc commenting?

tobe bondhu nouka bherao<br />shonabo gaan aj shara raat
Mark Spritzler

Joined: Feb 05, 2001
Posts: 17260

I would javadoc all your methods, even the private ones.

Perfect World Programming, LLC - Two Laptop Bag - Tube Organizer
How to Ask Questions the Smart Way FAQ
Have you tried LearnNowOnline? http://www.learnnowonline.com/
subject: Documentation Comments (scjd)