TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I don't think that the "greatest good for the greatest number" does the
"greatest good" for any of the "number".
I think the *user* should decide what goes into the document in his or her
hands. To (probably misquote) Edmond Weiss, "It is a fallacy to think that
there is only one manual. There are as many manuals as there are audiences."
In the world of paper docs, practicing this can be difficult and expensive. In
the world of online docs, individual users should be able to customize their
online help to include the information they need to know without having to wade
through information they don't need to know.
Then, again, the best documentation I've seen in the last two weeks wasn't even
documentation -- it was some simple stencilled labels on PC boards, identifying
each jumper, what it did, and what the factory default setting was ...
JFOA. Agreements/rebuttals welcome. HAND!
David Jones, Technical Writer
David_Jones/KSBEISD -dot- KSBEISD -at- Datahub -dot- com
Kamehameha Schools Bishop Estate
"I do not speak for my employer, my computer, or any other living thing."
Post Message: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
Get Commands: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "help" in body.
Unsubscribe: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "signoff TECHWR-L"
Listowner: ejray -at- ionet -dot- net