Instruction Manual Plans

Instruction Manual Plans

The traditional form of help documentation is a hard copy manual that is printed out, nicely bound, and functional. It serves as a reference manual - skim the TOC or index, find the page, and follow the directions step by step. The challenge with these types of documents is that user manuals can often become jumbled and hard to understand. And in an effort to fix this issue, writers can try to employ what I call "look over here" techniques to minimize the wordiness and simplify the content.

I have found this approach to be extremely ineffective most of the time. Why? Because user manuals are not meant to be flipped through 10 times for one task. That is what online help is for.

So how can we create a good user manual?

Well, we do so by dividing the content up and presenting it in a self-contained manner. In this way, ALL of the information necessary to perform that task is present in that section of content. Take this basic scenario of a sample page from a user manual, and see if you can tell what's wrong with it:

Logging into the application

1. Open the Start Menu. If you do not know how to access the Start Menu, see page 5.

2. Locate Application A, and double click to open it. For more information about how to do this, see page 2. If you do not see the program listed, go to page 6 for troubleshooting.

3. On the login screen, enter your user name. For more information about where to get your user name, see page 3.

4. Enter your password. If you have forgotten your password or are not sure what your password is, see page 4.

5. Click OK to log in.

Does it look concise and pretty? Yes. Does it appear easy to scan? Sure. But is it effective? No.

Why?

In the scenario above, we have turned five simple steps into an extremely complex, page-flipping process whereby the user has to go from page to page in order to perform a simple task. The workflow looks something like this: page 1, page 5, page 1, page 2 or page 6, page 1, page 3, page 1, page 4, page 1.

Why put the user through this? And imagine if the pages weren't close together or there were 20 steps in the process? Let's say the manual was 200 pages long, and the user had to flip from page 25, to page 72, to page 4, to page 169, etc...

The best way to format a user manual is to create self-contained modules that have all of the necessary information within the module. Page flipping should be minimized. However you must be careful to format the text so that it still maintains its readability. How do we do this? By using bullets and notes.

My rule of thumb is: have your main action in the step, and any supplementary instructions in bullets or a note. That way, if the user doesn't need the extra help, he/she can move forward quickly and not be encumbered by excess information. Visit the Technical Writing section of the blog on my website for an expanded version of this article, plus a correctly formatted version of the example user manual page above.

Need additional tips and suggestions, or want help creating communications for your business? Visit my website at http://www.writerliz.com. I am a professional writer with nearly six years of corporate experience. I have a B.A. in English and can provide free writing tips to aspiring writers, or paid professional writing services to businesses and corporations.

Instruction manual $3 Instruction manual

instruction manual (SET) $4 instruction manual (SET)

Brother Instruction Manual imbr-XL2021 $19.99 Brother Instruction Manual imbr-XL2021

Brother Instruction Manual imbr-XL2022 $19.99 Brother Instruction Manual imbr-XL2022

Brother Instruction Manual imbr-XL2027 $19.99 Brother Instruction Manual imbr-XL2027

Brother Instruction Manual imbr-XL2030 $19.99 Brother Instruction Manual imbr-XL2030

Brother Instruction Manual imbr-XL3030 $19.99 Brother Instruction Manual imbr-XL3030

Brother Instruction Manual imbr-XL5001 $19.99 Brother Instruction Manual imbr-XL5001

Brother Instruction Manual imbr-XL700 $19.99 Brother Instruction Manual imbr-XL700

Brother Instruction Manual imbr-PS2500 $19.99 Brother Instruction Manual imbr-PS2500

Brother Instruction Manual imbr-VX1010 $19.99 Brother Instruction Manual imbr-VX1010

Brother Instruction Manual imbr-VX1100 $19.99 Brother Instruction Manual imbr-VX1100

Brother Instruction Manual imbr-VX1120 $19.99 Brother Instruction Manual imbr-VX1120

Brother Instruction Manual imbr-VX2080 $19.99 Brother Instruction Manual imbr-VX2080

Brother Instruction Manual imbr-VX520 $19.99 Brother Instruction Manual imbr-VX520

Brother Instruction Manual imbr-VX540 $19.99 Brother Instruction Manual imbr-VX540

Brother Instruction Manual imbr-VX560 $19.99 Brother Instruction Manual imbr-VX560

Bernina 1000 Instruction Manual $29.99 Bernina 1000 Instruction Manual

Brother Instruction Manual imbr-VX640 $19.99 Brother Instruction Manual imbr-VX640

Brother Instruction Manual imbr-VX757/760/770 $19.99 Brother Instruction Manual imbr-VX757/760/770

Brother Instruction Manual imbr-VX780 $19.99 Brother Instruction Manual imbr-VX780

Brother Instruction Manual imbr-VX790 $19.99 Brother Instruction Manual imbr-VX790

Brother Instruction Manual imbr-VX807 $19.99 Brother Instruction Manual imbr-VX807

Brother Instruction Manual imbr-VX808/9 $19.99 Brother Instruction Manual imbr-VX808/9

Brother Instruction Manual imbr-VX847/70 $19.99 Brother Instruction Manual imbr-VX847/70

Brother Instruction Manual imbr-VX857/80 $19.99 Brother Instruction Manual imbr-VX857/80

Brother Instruction Manual imbr-VX890 $19.99 Brother Instruction Manual imbr-VX890

Brother Instruction Manual imbr-VX940/50 $19.99 Brother Instruction Manual imbr-VX940/50

Brother Instruction Manual imbr-VX970 $19.99 Brother Instruction Manual imbr-VX970

Brother Instruction Manual imbr-XL1001 $19.99 Brother Instruction Manual imbr-XL1001

Brother Instruction Manual imbr-XL2001 $19.99 Brother Instruction Manual imbr-XL2001

Brother Instruction Manual imbr-XL2010 $19.99 Brother Instruction Manual imbr-XL2010

Brother Instruction Manual imbr-XL2015 $19.99 Brother Instruction Manual imbr-XL2015

Babylock Instruction Manual imbl-BL200 $24.99 Babylock Instruction Manual imbl-BL200

Brother Instruction Manual imbr-XL711 $19.99 Brother Instruction Manual imbr-XL711

Babylock Instruction Manual imbl-BL1000 $24.99 Babylock Instruction Manual imbl-BL1000

Babylock Instruction Manual imbl-BL1400 $24.99 Babylock Instruction Manual imbl-BL1400