Re: Elegance

Subject: Re: Elegance
From: Ronni Geist <ronni -at- GEISTWRITERS -dot- COM>
Date: Thu, 23 Apr 1998 15:50:42 -0400

Wayne Douglass wrote:

> You can't write a manual that's better than the product.
> --Wayne


Sorry, Wayne, but I beg to differ...

I've documented some pretty awful (consumer) hardware and software -- in
environments where the developers constantly stressed:
"Those are NOT bugs, they're features!"
"Works as designed!!!"

Yet a good documentation team:
* can make a difficult product easy to install and use

* can recommend troubleshooting fixes for when the hardware/
software doesn't do things as you'd expect it should

* can present it in a clear, concise, user-friendly manner
(with screen shots, bullet/number lists, and a comprehensive
TOC and Index) so that end-users don't realize that the product
is nearly as bad as it really is.

I was the manager of a doc department. As they say,
"Been there...done that!"


Ms. Ronni Geist
Director, Editorial Services
ronni -at- geistwriters -dot- com

Previous by Author: Re: Defining Readability Levels
Next by Author: Re: Elegance
Previous by Thread: Re: Elegance
Next by Thread: Re: Elegance

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

Sponsored Ads