14 Oct
Posted by Scott as authoring, opinion, technical communication

Power user. It’s a term that I don’t like. But there definitely are people out there who are working with the software and hardware that we document who want more than just basic information. Getting them that information can be tricky.
For years, I’ve felt that a manual actually offers very little benefit to power users. Why? Most of them want to quickly and efficiently learn how to carry out an advanced task. Thumbing through a manual or cookbook-like guide slows that process down.
I’ve found that in many cases, documentation for power users should be task based, but also as long or as short as needed. When I say as long or as short as needed, I mean just that. You might have a four or five step procedure. Or, you might have a piece of documentation that contains a considerable amount of overview and expository material interspersed with the procedures.
As for the form that this kind of documentation might take, here are a few suggestions:
If you’re wondering what a tech note is, I define it as a document that’s a cross between a white paper and a knowledge base article. It provides details about an advanced or little-used feature or a function of a technology, along with information on how to use that feature or function.
Regardless of the form that the documentation for a power user takes, you should always keep my one of my favourite and most over-quoted thoughts from Tim O’Reilly in mind:
People are looking for advanced tips and tricks. They’re not looking for the basics. They’re looking for things that will give them more of an edge. And they’re looking for it in a style that’s fun and engaging.
What’s your take on this? Feel free to leave a comment.
Photo credit: dzz from morguefile.com
Related posts:
7 Responses
Scott Nesbitt (scottnesbitt) 's status on Wednesday, 14-Oct-09 11:50:17 UTC - Identi.ca
October 14th, 2009 at 7:50 am
1[...] http://www.dmncommunications.com/weblog/?p=1473 a few seconds ago from BeTwittered [...]
Tweets that mention A few thoughts on documentation for the power user by Communications from DMN -- Topsy.com
October 14th, 2009 at 10:33 am
2[...] This post was mentioned on Twitter by DMN Communications, Julio Vazquez. Julio Vazquez said: RT @Arroxane: RT @dmnguys: [Blog post] A few thoughts about documentation for the power user – http://bit.ly/44yWIn [...]
Ivan Walsh
October 14th, 2009 at 8:23 pm
3Hi Scott,
IBM publishes a series of books dubbed Red books, many of which are aimed at power users.
These have little value for novice users but are jammed packed with detailed info for those who want to get under the hood and really see how things work.
http://www.redbooks.ibm.com/
Regards,
Ivan
Scott
October 18th, 2009 at 11:26 am
4@Ivan, the IBM RedBooks are written by power users for power users. I remember reading or hearing someone involved with the RedBooks describing the process of writing them. At least, a few years ago. IBM gathered a bunch of experts together for a week, gave them a crash course in FrameMaker, and set them writing. Sort of like a FLOSS Manuals book sprint.
Don’t know whether the process has changed or not, but it’s an interesting way of putting together a book.
uberVU - social comments
October 19th, 2009 at 9:07 am
5Social comments and analytics for this post…
This post was mentioned on Twitter by dmnguys: [Blog post] A few thoughts about documentation for the power user – http://bit.ly/44yWIn...
Gordon
October 20th, 2009 at 3:28 am
6At the TCUK conference Peter Angelhides delivered the keynote (he works for IBM) and I’m sure he said that the Red Books are (now) written by tech writers embedded in the Support Team.
The way my team are adopting this challenge is to stop worrying about the lowest level of ‘how’ information (procedures, the click, click, click, stuff) and make sure we are nailing the ‘why’ and capturing what I call “grey” information – those snippets of knowledge that people using the tools just know but can be hard to capture (I think this falls into the Curse of Knowledge bracket, where most power users forget how much they didn’t know).
Another way we are toying with is to ditch the old “manual” view of the world, and rather than trying to group information a certain way, just group subsets that relate to each other, dump the TOC and open our online information with a Google-esque search page.
Gordon´s last blog ..Selling ourselves
Scott
October 20th, 2009 at 6:57 am
7@Gordon, interesting ideas as always. I like the thought of ditiching the idea of the manual, and that’s a lot like something that I’ll be disucssing in an upcoming presentation.
RSS feed for comments on this post · TrackBack URI
Leave a reply
Blogroll
Past Entries
Communications from DMN is proudly powered by WordPress - BloggingPro theme by: Design Disease