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 am putting together a collection of documentation examples
for my students. As I began wading through software manuals
and instruction guides, it occurred to me that you might
have valuable opinions. IMVHO the worst commercial
documentation I ever saw was put out by Wildcat back in
1993. It was basically unreadable and unusable--even the
index was completely wrong (it didn't match the book). More
recently, Asymetrix took the title with their documentation
for Toolbook 3.0. 4.0 is better.
The best documentation I ever saw was for an obscure company
that made computer tables. It began with "Go get a cup of
coffee, this is a one cup of coffee project."
My question is this:
Where can I find the very best and worst examples of
documentation?
What, in your opinions, make them good or bad?
Thanks. . .
Dave Hailey
Here at USU
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-
