Re: Best Documentation

Subject: Re: Best Documentation
From: Dick Margulis <margulis -at- fiam -dot- net>
To: Anthony Markatos <tonymar -at- hotmail -dot- com>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 08 Feb 2000 20:46:49 -0500

Anthony Markatos wrote:
>
> Kathi, these are all what Hackos calls documentation "manufacturing" issues.
> As such, they are all relatively easy to correct. It is failures in
> planning, analysis, and overall organization that cause the big
> (next-to-impossible to correct) problems.
>


Tony,

"Manufacturing" issues can cause bridges to crumble and airliners to
fall from the sky. Sometimes they result from poor execution at the
point of manufacture, not in the engineering department.

You can have the best-planned, best-organized documentation in the
world, but if the user cannot make head nor tail of it because it is
poorly written, poorly edited, poorly translated, poorly composed, or
poorly printed, then it is ineffective.

Dick




Previous by Author: Re: Printed Manual Format / Size / Cover Materials
Next by Author: Re: OT: How would you pronounce this word...? (no, it's not in a dictionary)
Previous by Thread: Re: Re[4]: Best Documentation
Next by Thread: RE: Best Documentation


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


Sponsored Ads