RE: Metrics (Re: How do hiring companies view TW resumes?)

Subject: RE: Metrics (Re: How do hiring companies view TW resumes?)
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: Paul Goble <pgcommunication -at- gmail -dot- com>, TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 23 Mar 2010 11:16:34 -0400

Paul Goble wrote:
> The best metric I've seen came about when the whole company
> embarked on a
> Single-Unit Marketing Model study to evaluate which factors
> drove customer
> decisions. It was based on an elaborate survey which asked
> customers to
> allocate a theoretical budget between us and our competitors,
> then asked how
> that would change "if X were improved" or "if X declined," where
> X=documentation, usability, ease of ordering, etc. During
> the few years
> when the data was valid, it was easy to say, "If we make our
> documentation
> better, we will gain $Y in revenue; if we let it get worse,
> we will lose
> $Z."


How did you manage to get customers to participate in "an
elaborate survey"?

How did you avoid selection bias?

How did you validate the responses? (E.g., how did you
know that some of the answers didn't come from a
bored techwriter at the customer company? Or a
disgruntled engineer, or a purchasing rep with a
sense of humor?)

For the list: Is anybody getting results from surveys
and polls? How are you implementing/administering them?

What do you (list-members) use for incentive to get
busy people, whom you have never met, who live and
work on the far side of the world, and speak/read
your language as their second or third, (and where
the purchasing department might not even reside in
the same timezone as the end-user/administrator of
your product) to take time from their own deadline
rush in order to fill out forms and answer questions?

I've had little result (none...) in the past from
a standalone "How are we doing; what can we improve?"
page in my help.
I was thinking of re-introducing it in an upcoming
release and adding a link to it at the bottom of
each and every help topic/page.

- Kevin

The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.


Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial:

Explore CAREER options and paths related to Technical Writing,
learn to create SOFTWARE REQUIREMENTS documents, and
get tips on FUNCTIONAL SPECIFICATION best practices. Free at:

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Please move off-topic discussions to the Chat list, at:


Metrics (Re: How do hiring companies view TW resumes?): From: Paul Goble

Previous by Author: RE: Survey sez: your favorite local-drive search tool
Next by Author: RE: Metrics (Re: How do hiring companies view TW resumes?)
Previous by Thread: Metrics (Re: How do hiring companies view TW resumes?)
Next by Thread: Re: Metrics (Re: How do hiring companies view TW resumes?)

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

Sponsored Ads