Meaningless Drivel is fun!*
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes HTML user guide question Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login


Win a copy of OCM Java EE 6 Enterprise Architect Exam Guide this week in the OCMJEA forum!
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "HTML user guide question" Watch "HTML user guide question" New topic
Author

HTML user guide question

Raf Szczypiorski
Ranch Hand

Joined: Aug 21, 2008
Posts: 383
Hi. Being a non-native english speaker, I have a problem understanding this sentence:

"However, if the documentation is not online, you must provide either a single plain ASCII (not word processor format) text document, which must be called userguide.txt, or multiple HTML files which must all be accessible from a starting point document that must be called userguide.html."

As I understand it, I must provide multiple html files linked to by userguide.html. Why the heck do I have to provide multiple html files? Can't it be only one file, userguide.html?

Raf
Roel De Nijs
Bartender

Joined: Jul 19, 2004
Posts: 5231
    
  12

A single userguide.html will do, but if you have multiple html files or multiple files (images for example) it will all have to be accessible through userguide.html


SCJA, SCJP (1.4 | 5.0 | 6.0), SCJD
http://www.javaroe.be/
Raf Szczypiorski
Ranch Hand

Joined: Aug 21, 2008
Posts: 383
I think I will go for a text file, it's much work... I don't expect any images ;d
Roel De Nijs
Bartender

Joined: Jul 19, 2004
Posts: 5231
    
  12

I also used a single plain ascii text file, just a few simple instructions, no images needed.
Roberto Perillo
Bartender

Joined: Dec 28, 2007
Posts: 2265
    
    3

Roel De Nijs wrote:I also used a single plain ascii text file


Me too!


Cheers, Bob "John Lennon" Perillo
SCJP, SCWCD, SCJD, SCBCD - Daileon: A Tool for Enabling Domain Annotations
Andrew Monkhouse
author and jackaroo
Marshal Commander

Joined: Mar 28, 2003
Posts: 11437
    
  85

Whereas I had an older assignment (Fly By Night) and I had lots of HTML files for the user documentation, and even more for the design documentation, including class diagrams and screen shots and ....

(Yes, I well and truly overdid my submission.)


The Sun Certified Java Developer Exam with J2SE 5: paper version from Amazon, PDF from Apress, Online reference: Books 24x7 Personal blog
Raf Szczypiorski
Ranch Hand

Joined: Aug 21, 2008
Posts: 383
Heh. But I am just a normal guy next door, no world-class ninja ;d
Roel De Nijs
Bartender

Joined: Jul 19, 2004
Posts: 5231
    
  12

Andrew Monkhouse wrote:(Yes, I well and truly overdid my submission.)

We try to encourage and convince people just sticking to the assignment and the must requirements, and not overcomplicate or do things which are not required. And then the author of the SCJD book homself makes such a statement
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: HTML user guide question