user feedback

Subject: user feedback
From: Ryan Young <ryangyoung -at- gmail -dot- com>
To: tech2wr-l <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 18 Jun 2013 10:13:54 -0700

It's a good thing, I think. But I've been wondering recently how best to
solicit and manage it. We have a system here, but it's far from perfect and
I'm trying to think of ways to improve it. Broadly speaking, the goals are
to 1) increase the volume of useful comments/feedback 2) create an
efficient process to funnel the feedback to the writers. The ultimate,
overarching goal (obviously?) is to use the feedback to improve the docs to
a point where users don't need to call support--or at least call support

This is how we currently have things set up: all of our documentation is on
a public site available as pdf or html. (A few doc sets are
password-protected so only customers and partners can see them.) The html
version supports comments and replies, but not the contextual help that's
installed with the application. Comments and replies are visible in the
html help and are also sent to a private instance of our enterprise social
network, which, since it's private only serves as a repository. I reviewed
all the comments and created doc tasks for all the comments that seemed
valid and useful. From there, the writers generally fixed the (usually
minor) issues in the source files so they'll be ready for the next release.

This seems like an OK process, but not a lot of people are submitting
comments. I think that's because no follow-up was performed when they first
rolled out and touted this new feature. People submitted comments, heard
nothing back and, I'm guessing, assumed no one was reading their comments
anyway so why bother.

How have other people on the list collected, managed, and responded to user
feedback? How useful *is *it?
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more:


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-leave -at- lists -dot- techwr-l -dot- com

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

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @

Previous by Author: Back to SGML (ugh) after yrs of XML - AF TOs - State of the Zoo Qs
Next by Author: Assistance Needed for Technical Communication Survey
Previous by Thread: Re: Use of plug-in/unplug
Next by Thread: Re: Numbered versus unnumbered heads in very technical reference guides

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

Sponsored Ads