File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
http://aspose.com/file-tools
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes Questions regarding JavaDoc for URLyBird (1.1.2) Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "Questions regarding JavaDoc for URLyBird (1.1.2)" Watch "Questions regarding JavaDoc for URLyBird (1.1.2)" New topic
Author

Questions regarding JavaDoc for URLyBird (1.1.2)

Alex Duran
Greenhorn

Joined: Jan 29, 2007
Posts: 8
I'm finally resuming work on my SCJD assignment (I purchased the assignment in 2002...better late than never).

I have two questions regarding the creation of JavaDoc for the assignment. The instructions read:

"Awkward or complex code should have descriptive comments, and javadoc style comments must be used for each element of the public interface of each class. You must create a full suite of documentation for the classes of the completed project. This must be generated using the tool "javadoc" and must be in HTML format. Provide javadoc documentation for all classes you write."

My questions are:
a) Has anybody elected to generate JavaDoc comments for "protected" members as well? In the real world, I would be inclined to always document "protected" members since they are contractual (i.e. this is available to subclasses outside the package or the class itself). And if you did generate these comments - were points deducted for doing so?

b) Did you also create JavaDoc comments for the supplied suncertify.db.DB interface? The source code has been provided for this interface, but it does not include documentation comments. I would like to create JavaDoc comments for this interface (and maybe add some whitespace characters!), but I am concerned that the graders my automatically fail any assignment that introduces any changes to DB.java.

Thank you.


SCJP
Martin Wittmann
Greenhorn

Joined: Jan 23, 2007
Posts: 5
Hi Alex

I did provide JavaDoc for protected members
and for the supplied suncertify.db.DB interface.

The graders did not seem to mind.

Cheers,
Martin


SCJP<br />SCJD<br />SCWCD
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: Questions regarding JavaDoc for URLyBird (1.1.2)