Re: Flawed software

Subject: Re: Flawed software
From: David Blyth <dblyth -at- QUALCOMM -dot- COM>
Date: Thu, 1 Feb 1996 20:23:53 -0700

Hi All;

Tom Lange says...

> I have yet to see perfect documentation for an unflawed software
> product. Actually, I have yet to see an unflawed software product.

Why isn't a perfect document possible? IMHO, you can perfectly document
how to use a bad product to shoot yourself in the foot (or head). This
is sometimes a good way to try getting a bug fixed.

> It is even possible (not easy, but possible) to use documentation
> to make some, most, or all of the flaws or bugs look like real
> features by writing about what the flaw does, not about what
> it does not do.

I know of at least one case where "what the flaw did" was completely
trash all the work the customer did up to that point. However, I
did take your advice - I documented it. ;)

> It is possible to write documentation that makes a badly flawed
> product look less flawed.

IMHO, this is not necessarily A Good Thing. The idea is to document
how the product works, no matter how it works (or doesn't work). I
am not hired to make my boss or marketing happy. I am hired to document
how the product works.




David (The Man) Blyth
Technical Writer
Qualcomm

The usual disclaimers apply - I don't speak for QUALCOMM, they don't speak
for me....


Previous by Author: Re: Printed and HTML from one source
Next by Author: Re: Flawed software
Previous by Thread: Re: Flawed software
Next by Thread: Flawed software


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


Sponsored Ads