Re: Document Feedback Form

Subject: Re: Document Feedback Form
From: "Hauglie, Joe" <jhauglie -at- ti -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 14 Sep 2007 12:40:15 -0500

Zen C asked about document feedback forms (13-Sept-2007).


Message: 22
Date: Thu, 13 Sep 2007 19:57:30 -0400
From: "Zen C" <zenizenc -at- gmail -dot- com>
Subject: Documentation Feedback Form

Does anyone provide users with a documentation feedback form? How effective
is it and what kind of questions are included in the form?


The primary documentation group within Texas Instruments has been using an automated feedback form inserted into the footer of XML-based documents over the past 18 months or so. We've had some interesting experiences, but it has been a mostly positive tool.

The form is available at: (When a customer selects the active link in a document, the literature number and part number fields are pre-filled with the respective information from the active document so the reader doesn't need to go hunting for it.)

The primary purpose of the form is to give readers a chance to point out both technical and non-technical documentation errors (typos, incorrect equations, improper units - mxing up "milliamps" with "microamps," and so forth). While the form has generated a great deal of email since it has been implemented, my estimate is that at least 1/3 (probably more) of the messages have been either requests for specific applications support or additional information on using a given device.

How effective is it? If "effective" is defined as, "do you get what you are asking for?" then I believe the form serves its purpose well. We have certainly had our share of finding mistakes that slipped past everyone, including me.

The downside of this particular format is that there is not a way to filter out the applications support requests. So there is a good deal more admin work to make the process function smoothly than we first anticipated.


Joe Hauglie
Technical Editor
Technical Information Systems
Texas Instruments - Tucson


Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

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.


Previous by Author: Re: request for eLearning samples
Next by Author: Re: MS Word
Previous by Thread: Re: Author-it [was: Single Sourcing tools]
Next by Thread: RE: Document Feedback Form

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

Sponsored Ads