Re: Value added by technical documentation

Subject: Re: Value added by technical documentation
From: "Wayne J. Douglass" <wayned -at- VERITY -dot- COM>
Date: Fri, 7 Mar 1997 13:54:29 -0800

At 03:45 PM 3/7/97 -0500, John Bell wrote:

>One project produced by a former employer was so poorly designed that the
writer
>I assigned to the project was overstressed. The manual ended up being 4-5 times
>bigger than it should have been if the UI had been designed properly. The
support
>effort needed on that product was way out of line compared to our other
products.

I used to have a slogan to describe this situation: "You can't write a
manual that's better than the product."

I remember getting a reader response card complaining that the installation
procedure in a manual was too complicated. They were right, but that's how
the product was installed.

--Wayne Douglass

=========================================================
Verity, Inc. Email: wayned -at- verity -dot- com
894 Ross Drive Telephone: 408-542-2139
Sunnyvale, CA 94089 Facsimile: 408-542-2040
Connecting People with Information: http://www.verity.com
=========================================================

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: Happy Egredior Day
Next by Author: Re: Creating indexes
Previous by Thread: Re: Value added by technical documentation
Next by Thread: Re: Value added by technical documentation


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

Sponsored Ads


Sponsored Ads