Re: Metrics

Subject: Re: Metrics
From: David Neeley <dbneeley -at- gmail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 24 Mar 2010 11:11:10 +0200

In a discussion of the frequently forlorn hope for metrics regarding
the contribution of documentation to a company's bottom line, I am
always reminded of the difficulty that colleges and universities have
historically had in explaining the financial value of a liberal arts
degree. Since there is seldom a direct correlation between the "fuzzy"
subjects embodied in liberal arts with income potential, that is
usually something of a lost cause as well.

A few years ago, at a meeting of the local STC chapter in Dallas, the
former docs manager from Texas Instruments related a story. Several
major customers of TI were asked why they selected TI components
rather than those of their competitors. The number one answer was that
the documentation was so good they had no trouble in incorporating
their components into the customer's designs.

For the next two or three years, the tech docs department was riding
high around there, until the powers that be began to forget that
result and things returned to their historical low level of regard and
tech docs were once again relegated in mindshare to the "necessary
evil" class.

Most companies don't do a very good job of studying what motivates
their customers--let's face facts. The majority of "studies" I have
seen are only to confirm prejudices, not to truly determine the
customers' motivations. Of course, often the customers themselves have
a poorly defined grasp of why they make the decisions they do as well.
They may take documentation for granted too. Or, in too many cases,
their experience with inferior documentation has meant that they
largely ignore it with new products. If you doubt this, ask any help
desk operator how often they field questions the answers for which are
clearly stated and easily found in the documentation! (There is, after
all, a reason for the time-honored acronym RTFM...)

The one bright spot--now that so much is moving "into the cloud"--it
will become quite easy to collect statistics for docs hosted on your
own cloud servers.

David
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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: http://www.doctohelp.com

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:
http://www.ModernAnalyst.com

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Previous by Author: Spokn
Next by Author: Format overrides; was: RE: Top 10 mistakes unstructured FrameMaker Users make
Previous by Thread: Tool to handle pdf books and online help systems?
Next by Thread: re: Metrics


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


Sponsored Ads