Category Archives: quick reference guides

A couple of weeks ago I gave an STC webinar called Designing Quick Reference Guides. This was a general STC webinar, and usually I am not allowed to repost the recording, but due to some audio difficulties, I had to re-record it, and the STC gave me permission to post the re-recording. Here are theContinue Reading »

In The Back of the Napkin, Dan Roam explains that drawing pictures can help you solve problems. He says the first rule is to “collect everything possible up front” (p.58). After collecting all your information, you then “lay it all out where you can look at it” (p. 61). By laying out all the information,Continue Reading »

I received another question from John from Delaware. It was actually in his other e-mail, but I neglected to address it because I don’t usually spend so much time answering readers’ questions. This one, however, addresses a topic I’m presenting on in a usability progression at the upcoming STC Summit in Atlanta. Concerned about theContinue Reading »

This is the proceedings writeup that my colleague Ben Minson and I wrote to accompany our presentation on quick reference guides for the upcoming STC Summit in Atlanta. Be sure to check out the quick reference gallery mentioned near the end. Tom’s Perspective: The Need for Shorter Documentation Several years ago, the customers I wroteContinue Reading »

Have you ever tried to adjust your office chair but couldn’t remember how to do it? Do you ever look at all the little levers under your seat and wonder how they work with the myriad muscles in your back? Don’t you wish you could just pull a quick reference guide … out of theContinue Reading »

One of the fundamental aspects of quick reference guides is knowing when to create them. A few weeks ago I was assigned to a small project team working on a relatively simple application, and I pitched the idea of several role-based quick reference guides for the help content. I showed samples from other projects, andContinue Reading »

Quick reference guides provide one or two page condensed instructions. Formats for quick reference guides vary dramatically and can involve complex, multi-colored layouts, or just simple text callouts next to a few images. The other day I stopped by a local thrift store (Desert Industries) and picked up a few magazines for $.25 cents aContinue Reading »