RE: Documentation Quality Metrics

Subject: RE: Documentation Quality Metrics
From: Marguerite Krupp <mkrupp -at- cisco -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 19 Aug 2002 14:57:04 -0400

The first questions that come to mind include:

"Who is your audience for these metrics?"
"What use will they make of these measurements?"
"What are the other departments measuring?" [ASK!]

Before expending a lot of time and effort on this project, it would be
useful to know this information.

Oh, and hie thee to a used bookstore and get a copy of _How to Lie with
Statistics_ by Darrell Huff. This 1960s book will give you a good idea of
some of the traps inherent in this type of activity.

Of course, if the answer is, "Just do it!", then you know something, too.
Cynically, in this instance, I'd say make the stats come out the way that's
most favorable to your group's objectives... [she said, reaching for her
flameproof garments].


Want to support TECHWR-L? Get shirts, bags, hats, clocks,
and more from the TECHWR-L Store. All proceeds support TECHWR-L.

Check out the new release of RoboDemo, our easy-to-use tutorial software.
Plus, buy RoboHelp Office in August and save $100 with our mail-in rebate.
Get details and download free trial versions at

You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: RE: To STC or not to STC?
Next by Author: RE: Book Recommendation? technical illustrations and screenshots
Previous by Thread: Re: Documentation Quality Metrics
Next by Thread: Re: Documentation Quality Metrics

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

Sponsored Ads

Sponsored Ads