Userguide question.

[Mihai Radulescu]

Hi

I am ready with my URLyBird - I start to prepare the deploy and I have a small question about the the documentation.

My GUI provides an online help based on chained HTML files - this files are accessible from the GUI side via the online help system, thats why all this html files are packed in the runme.jar.
According with my specification I need to provide user documentation for the database and server

User documentation for the database server and the gui client. If your user documentation is online then you may omit this file. 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.

I choose the html version. For this I make a separate copy of the html files form the online help, I provide an userguide.html start page and I chain this to the online help files. But in this way I have the online help two times once in my jar for the online help and once for the userguide, this is a little bit redundant.

What you people think about ?

Regards M

[Darya Akbari]

Hi Mihai,

seems somewhat redundant to me .

Originally posted by Mihai Radulescu:
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

Regarding your assignment quote one version either online (your help) or as HTML file (userguide.html) should be sufficient.

I used the userguide.txt variant

Regards,
Darya

[Mihai Radulescu]

Hi Darya.

Do you mean, you provide online help and userguide.txt

Regards M.

[Darya Akbari]

I submitted only userguide.txt

[Leszek Zajac]

My undestanding of this is that you should only provide one item.
That is:
online help system or userguide.txt or userguide.html (+ other html files)

Best regards

[Mihai Radulescu]

From my specification :

User documentation for the database server and the gui client. If your user documentation is online then you may omit this file. 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.

please notice the you may (...then you may omit this file). The only must comes after and regards the missing if the documentation.
I interpret this in this way:
1.you must provide documentation
2.you can provide an online help system or
3.you can choose the plain text file
4.if you provide the online help system you can (this is your choice) omit the point 3 or 4


What you guys think about ?

[Darya Akbari]

Hi Mihai,

for the redundancy no one can punish you. If you feel safer when you put the extra userguide.html to your submission then go ahead . You only don't get extra points for them.

But take care about the musts. The musts are the one that kills.

I counted 81 musts in my assignment and made a list of them. That helped a lot and I really looked for complying with each must out of my 81 musts.

See this thread: How to cope with assignment's MUST conditions

Good Luck,
Darya

[Mihai Radulescu]

Thanks for link,
I don't risk so I choose the redundant solution (online help and userguide.html).

Regards M