Re: troubleshooting guide

Subject: Re: troubleshooting guide
From: Elna Tymes <etymes -at- LTS -dot- COM>
Date: Thu, 10 Jul 1997 09:12:13 -0700

Nancy McDonald wrote:

> does anyone have some advice
> regarding writing a troubleshooting guide?

Having written some for books and manuals, the most useful
troubleshooting guide I ever did was also in the most arcane symbology -
an old Telco standard that required it all be in flowcharts, using only
four symbols: rectangle for action, diamond for decision box, small
circle for offpage connector, and an oblong whose function I can't now
remember. The flowchart approach required the user to phrase a
question, then find something similar to the question in the TOC and
look at that page's diagrams. It was very easy to follow, and I was
told these particular users loved it.

If you look at some of Microsoft's current Help products, you'll find a
similar approach in terms of the questions, but the answers are all in
words. The premise is that you decide what you are trying to do, and
find a question that pretty much asks the same thing. An alternate
approach is when you have a system with only a limited number of failure
modes, where each kind can be easily identified (a particular
combination of lights flashing, a particular sound, etc.).

Elna Tymes
Los Trancos Systems

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: minimalist documentation?
Next by Author: Re: success with finding jobs
Previous by Thread: Re: troubleshooting guide
Next by Thread: Re: troubleshooting guide


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


Sponsored Ads