• 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

Documentation? user documentation? file that documents major designs?

 
Ranch Hand
Posts: 80
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
In the handout, sun describes the README.txt in detail. My questions are:
1) what do they want in the user documentation? and what form should it be, that is should it be userDoc.txt or userDoc.doc or what?
2) What for should the design choice document be? for example should it be designChoice.txt or designChoice.doc or what?
 
Ranch Hand
Posts: 125
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi Ahoo! Since user guide should be exposed to the user "on-line" , I think it can be in html format.
The design considerations MUST be an ascii file (es. txt) because it can be opened with an editor like VI.
Absolutely you can't use the .doc format (MS Word) !! You can't assume they will read your documentation on WIN platform and they'll have the MS Word installed on their machine!
Hope it helps...
 
Jim Martin
Ranch Hand
Posts: 80
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Thank you Andrea
 
Ranch Hand
Posts: 194
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Hi Ahoo,
I had a simple HTML file describing the available functions and how to trigger them. This help file was displayed in a separate frame when the help button was pressed.
Hope this helps.
 
Greenhorn
Posts: 28
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
How do u specify the file name and path to load it to the JEditorPanel? keep in mind that you do not know the name of the directory that the source file reside in
thanks
 
Mag Hoehme
Ranch Hand
Posts: 194
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator

Originally posted by fadi mujahid:
keep in mind that you do not know the name of the directory that the source file reside in
thanks


Use a path relative to the current directory.
 
reply
    Bookmark Topic Watch Topic
  • New Topic