best documentation

Subject: best documentation
From: David Hailey <FAHAILEY -at- WPO -dot- HASS -dot- USU -dot- EDU>
Date: Wed, 10 Jul 1996 15:52:57 -0600

Hi everybody,

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

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-

Previous by Author: Re: USAGE: screwdriver
Next by Author: Re: electronic books--info needed -Reply
Previous by Thread: Re: Microsoft Press
Next by Thread: Re: best documentation

What this post helpful? Share it with friends and colleagues:

Sponsored Ads