File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes HTML documentation 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 "HTML documentation" Watch "HTML documentation" New topic

HTML documentation

Cedric Bompart

Joined: May 22, 2002
Posts: 5
Can I submit my user guide and design choices document in HTML format?
Sai Patnala
Ranch Hand

Joined: Jan 09, 2002
Posts: 60
Yes. See the following lines from instructions.
A README.txt file. You must create a single text file (plain ASCII format; word processor formats are unacceptable) called README.txt that describes to the examiner the following information in exactly the order listed:
Design choices document location is supposed to be listed in readme.txt. It doesnt say which format it is supposed to be. Advised to provide full documentation including UML diagrams as well cas use-case documents etc.
However, JavaDocs and other documentation can be in HTML. Infact JavaDocs will be in HTML only, for all classes, new, modified or supplied.

Cedric Bompart

Joined: May 22, 2002
Posts: 5
do I need to produce cross-platform HTML? currently I generate my HTML pages from Word and it's a bit 'shit' on Linux...
Nigel Browne
Ranch Hand

Joined: May 15, 2001
Posts: 673
I scored the maximum on documentation. This is what I did.
One text file README which included everything mentioned in requirements document.
Design Choices text file, included all the design decision I made e.g why use RMI instead of Sockets, how I programmed the lock/unlock methods e.t.c. It had no UML
Online help in the form of HTML with jpg screen shots explaining how to book, search e.t.c. This was packaged in the jar files I submitted.
Cedric Bompart

Joined: May 22, 2002
Posts: 5
Word 2000 compact HTML
HTML tidy
I agree. Here's the link:
subject: HTML documentation
It's not a secret anymore!