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.
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
>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
>effort needed on that product was way out of line compared to our other
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.
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