• Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Campbell Ritchie
  • Jeanne Boyarsky
  • Ron McLeod
  • Paul Clapham
  • Liutauras Vilda
Sheriffs:
  • paul wheaton
  • Rob Spoor
  • Devaka Cooray
Saloon Keepers:
  • Stephan van Hulst
  • Tim Holloway
  • Carey Brown
  • Frits Walraven
  • Tim Moores
Bartenders:
  • Mikalai Zaikin

HTML documentation

 
Greenhorn
Posts: 5
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi,
Can I submit my user guide and design choices document in HTML format?
Regards,
Ced.
 
Ranch Hand
Posts: 60
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
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
Greenhorn
Posts: 5
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
do I need to produce cross-platform HTML? currently I generate my HTML pages from Word and it's a bit 'shit' on Linux...
 
Ranch Hand
Posts: 704
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
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
Greenhorn
Posts: 5
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Word 2000 compact HTML
HTML tidy
JTidy
 
With a little knowledge, a cast iron skillet is non-stick and lasts a lifetime.
reply
    Bookmark Topic Watch Topic
  • New Topic