Recently, a user sent an email to the KDE documentation list complaining that the KDE4 documentation left him in the cold after upgrading from KDE3.  This is something the Gnome documentation team needs to be careful with as we think about the Gnome3 help.  We’ll have a lot of Gnome2 users who are disoriented, and it’s our job to help them.

Brad Hards replied to the user, pointing out that KDE documentation is a volunteer effort, and asking the user to contribute something.  I am entirely sympathetic to this response.  I understand the difficulties of trying to produce good help with a skeleton crew of volunteers.  But from the perspective of actually helping the user, it’s a complete fail.  And at the end of the day, we do what we do to help users.

Here is how I think one should respond to a message like this:

  1. Sincerely apologize to the user.  Don’t make excuses.  Don’t use volunteerism as an excuse.  If your apology starts with “I’m sorry, but”, you’re doing it wrong.
  2. Identify exactly what problems the user is having and how the documentation could have helped the user.  Try to keep an open line of communication with the user.  Do not try to get the user to do work.  Just try to understand his problem better.
  3. Write some documentation to help the user.  Don’t worry too much about getting it plugged into whatever documentation system you have.  Don’t worry too much about making it a final copy.  The goal is to have real instructional information that can be reviewed.  Use a wiki or your blog or whatever you find most convenient.
  4. Ask the user to review what you’ve written.  You’re not asking the user to be a copy editor or a proofreader.  You’re asking him to tell you if this new documentation is helpful.
  5. Revise.  Repeat.
  6. When the new documentation works, make sure to put it through whatever quality control systems you have in place and to get it integrated into your documentation system.

Here’s what this accomplishes:  First and foremost, it actually helps the user.  It takes a disgruntled and frustrated user and turns him into a satisfied user.  With this kind of personal attention, it might even turn him into a downright happy user.  Second, because we’ve helped the user by writing real documentation, instead of answering questions on a mailing list, we’re helping countless other users who will never take the time to email us.

Finally, by giving the user something very concrete to do, we’ve given him a low-barrier entry point for contributing to our community.  Maybe he’ll stick around.  Or maybe he’ll go back to whatever he was doing, just a little happier.  I don’t know.  But what I do know is that “Find something to do and do it” is not a good way to get new contributors.  “Here is a simple task that is relevant to you personally” is far more effective.

♫NP: Fred’s Slacks Pt. 1 by Mingo Fishtrap

2 Responses to “Helping Users in Need”

  1. Silke Says:

    Wow, first of all: Yay! My husband listens to me when I rant about what constitutes good customer service! (My area of research) :D

    Secondly, the last paragraph reminds me of goal setting theory. This is one of *the* most respected theories in the realm of Industrial-Organizational Psychology and has been shown to be extremely relevant and applicable. Here is a link that explains goal setting theory in easy language:

    http://www.mindtools.com/pages/article/newHTE_87.htm

    If you want more detail and scientific explanation, this article is a good introduction:

    Latham, G. & Edwin Locke, (2002) “Building A Practically Useful Theory of Goal Setting and Task Motivation,” American Psychologist, (57) 9:705-17.

    Wikipedia explains well why goals affect performance (which I think can be relevant to attracting and retaining volunteers for projects like Gnome):

    Goals can affect performance in three ways:

    1. goals narrow attention and direct efforts to goal-relevant activities, and away from perceived undesirable and goal-irrelevant actions
    2. goals can lead to more effort; for example, if one typically produces 4 widgets an hour, and has the goal of producing 6, one may work more intensely than one would otherwise in order to reach the goal
    3. goals influence persistence. One becomes more prone to work through setbacks or to work harder if pursuing a goal.

    There are 4 factors affecting the goal-directed efforts. Goal difficulty is the level of difficulty to achieve the goal. Goal commitment is the extent to which a person is interested to reach the goal. Goal specificity means the goal should be relatively clarity and precision to the target. Goal acceptance is the extent to which a person adopts a goal as his or her own.

    I’ll shut up now. :)


  2. […] Shaun’s Blog Fourteen hours to save the Earth « Helping Users in Need […]


Comments are closed.