Search results

Misleading Documentation Metrics

by Tom Johnson on Dec 14, 2011
categories: technical-writing

Mark Baker's post, Why documentation analytics may misread, presents an appealing argument about why it doesn't matter if just a few people read the manual. In his post, Mark argues that a small number of key influencers who read the manual can share the knowledge with a much larger group who do not read the manual. The effect of the manual, therefore, disseminates out to a much larger group, even if that group never reads the manual. Mark writes,

A user does not have to have read a manual (for manual, read any form or packaging of technical communication) for it to shape their actions and their behavior. I'm willing to bet that there is one person in your family who reads the manual for a new gadget and then teaches everyone else how to use it. (Since I am writing for technical writers, I am willing to bet that someone is you.) The manual reaches you at first hand, and the rest of your family at second hand. Your kids then probably show their friends how to use the gadget. Some of them will then pester their parents to buy the same gadget, and will then teach their siblings and parents how to use it. Let this process run for a while and you could well have thirty products sold and a hundred people knowing how to use them, all based on one person having read the manual.

I've seen this same principle in practice. I wrote some help for an application at work. As with most help material, not many people read it. But one person did actually read it rather thoroughly. In fact, since it was a wiki, he even contributed a lengthy article to expand the help. This same person is a volunteer forum moderator and participates actively in the forums each day. I don't think there's a thread in the forum that doesn't have a contribution from this individual.

In the forum, it turns out one of the most popular topics is the application I wrote help for. The volunteer answers a ton of questions about this application, disseminating the knowledge to a much wider group. The people who come to the forums to ask questions often don't crack open the help, but they feel its effects in one way or another.

Perhaps in writing help material, rather than envisioning the lowest common denominator, we should target our influencers -- the group that will help others. Paradoxically, maybe the information in the help will find a much greater distribution if we write for fewer people.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.