Yost's online doc survey
12-Mar-94 09:37:45
Sb: #90564-Yost's online doc survey
Fm: alec jason 71137,2632
To: Yost Group 76702,413
1. I'd rate the current docs about 9.
2. I would very much like to have some of the docs on on-line help.
3. Most important would be a comprehensive, hyper-text on-line index which
provides the relevant page number in the printed docs.
Beyond that I think it would be nice to have basic information available
on-line; perhaps, again, with references to the printed manual's page number
"for more help."
If you plan to have complete information on-line, _then_ a valuable feature
would be to have EXAMPLES whenever appropriate. I can learn very quickly seeing
an example of how to do something instead of reading through pages of text to
extract the information I need.
One place in the current docs (and in the R2 docs) which badly needs a few
simple examples is the "Command Line and Batch Rendering" section of the
Advanced User Guide. I spent HOURS trying to figure out which switches I needed
to include for batch rendering. A few examples simply showing several command
line setups with arrows explaining each of the switches and boldface for the
switches which are mandatory are really needed.
4. I don't think the on-line help should include all the detailed procedural
instructions like the printed docs. It's generally too hard to read that much
stuff on line.
I don't know what you're contemplating but we DO need the printed, paper docs.
Don't ever give them up. (I don't care what MS does!)
Alec Jason