Re: Estimating Quality Documentation?

Subject: Re: Estimating Quality Documentation?
From: "Jan Stanley" <janron -at- concentric -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 14 Sep 1999 13:22:23 -0400

Mark Baker writes

"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."

Perhaps it's just a question of interpretation, but when I read
"quality docs are *as short as possible* [emphasis mine]," I
don't interpret it as "short is always better"; rather, I take it
to mean that a good document contains all of the information that
is necessary, and no more -- it's complete, but not needlessly
long.

Regards,
Jan
janron -at- concentric -dot- net






Previous by Author: Re: What do you call this?
Next by Author: Re: Numbering Steps for Multiple Paths
Previous by Thread: Re: Estimating Quality Documentation?
Next by Thread: Re: Estimating Quality Documentation?


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


Sponsored Ads