Re: Estimating Quality Documentation?

Subject: Re: Estimating Quality Documentation?
From: "Anthony Markatos" <tonymar -at- hotmail -dot- com>
To: mbaker -at- omnimark -dot- com, techwr-l -at- lists -dot- raycomm -dot- com
Date: Wed, 15 Sep 1999 11:20:06 PDT

Mark Baker said:

This idea that "quality docs are a short as possible" has been bandied about quite a bit in this discussion, but it is really another case of misplaced metrics. ....Sometimes more is less. More instruction may lead to faster comprehension. Quality has nothing to do with length. Short is not better than long, or vice versa.

Tony Markatos responds:

Granted, sometimes the job is to generate very detailed instructions. In such case, of course, more documentation is required. But, per required level of detail, the less words the better.

Tony Markatos

Get Your Private, Free Email at

Previous by Author: Re: Estimating Quality Documentation?
Next by Author: Re: Writing QA/Test and Acceptance Plan docs
Previous by Thread: Re: Estimating Quality Documentation?
Next by Thread: Tape Recording End Users & SMEs

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

Sponsored Ads