Yost's online doc survey
12-Mar-94 22:42:50
Sb: #90564-Yost's online doc survey
Fm: John K. Jordan 71174,711
To: Yost Group 76702,413
Humble opinions on docs:
1) Usefulness of current 3DS hardcopy: 9.6125 (UNSOLICITED
COMMENT: The docs would be dang near perfect with a "Secrets of
the Masters" supplement based on excerpts from the 3DS demo
video tape)
2) Verbose, as requested…
I dislike online documentation escalation if hardcopy suffers.
You can't hang colored Post-it tabs out of key sections, you
can't scribble notes in the margins, you can't correct doc
errors, and you can't sneak it into boring staff meetings. <g>
(Does my dept. head read this?)
You also can't read or study online docs if the computer is
down, rendering, or <gasp> busy with some other program.
In the case where the hardcopy quality does not suffer, I like
online documentation if it is complete and searchable, includes
graphics, includes cut-and-paste where appropriate (for
example, like MathCAD or MS languages), is hyper browsable,
and it includes page number references to the hardcopy docs.
I do not find current help hints in 3DSr3 to be useful,
however they may be very useful to someone beginning to learn
the program. They should also be VERY useful for someone using
a cracked copy of 3DS.
The only "online" things that makes sense to me are:
A) a full blown CD-ROM based Help done right (full
hypertext, with online flics, clipable 3D objects, wow
tutorials with images of results,…) Also harder to bootleg.
and/or
B) little reference pointers to the hardcopy.
3) Suitable for online: The index (see 2B above).
4) Unsuitable: The sole reference, tutorial, and installation
manuals. For those who won't read books, let'm watch TV.
J K J