User Manual
Benefits of Creating User Documents In-house
OVERVIEW
For small companies, creating their product’s User Documentation in-house, provides benefits to the company, to (idle) staff, and to the product. This article describes the benefits and some downsides of producing User Documents in-house.
THREE OPTIONS
If you have no in-house writing staff you have three options:
1. No User Document for the product. This is NOT a valid option. Every product needs User Documentation. It completes your product package, and enhances the User’s experience with your product. Here are two examples of non-existent User Documentation:
* Tomatoes. Most people don’t know that before use, tomatoes should not be refrigerated. Refrigerating tomatoes before use will reduce their flavor and nutrition value.
* A Manual Can Opener. This can opener clamps on the can, thus the user does not have to squeeze the handles while operating the can opener. It came with no User Documentation, as “everyone could probably figure out how to use it.” This is wrong. After a few uses, the blades become slightly dulled, and the handles are very difficult to clamp and lock.
The simple tip of turning the knob while squeezing the handles makes the can opener easy to use. That tip could form the basis of a User Manual for the product. The manual should include instructions for care of the can opener. The absurd situation is that this clamp feature was the unique aspect of the product; but the feature becomes unusable because of no User Document.
How have you felt about products that came without User Documentation? Were you confused about the product and getting the most from it? User Documentation adds to the value of the product. Let’s look at how we can get it created.
2. Use an outside writing service or consultant. Technical writers may be an excellent choice to create your User Documentation. However, there may be downsides to using them.
* When documentation changes have to be made, the company has to re-hire the writer. If the writer were unavailable, then you have to wait or search for a new writer. When the new writer gets hired, a new orientation to the company and the project would have to start. Delays, delays, delays.
* An even more horrible thought is that the outside writer used some fancy piece of software to create the User Document, and you do not own that software. Thus you could not make any changes until you bought and learned that software, or hired an outside writer who uses the same software. (Most technical writers are enamored with a particular piece of esoteric writing software.)
Using the outside writer will force you to batch your documentation changes, making the literature out of date. (How many times have you seen product documentation that does not match the product? This happens because the company was waiting for the next major upgrade to update the User Documentation.)
3. Using idle employees in your company to create the User Documentation. The remainder of this article will focus on this option.
STAFFING BENEFITS
In most organizations, there is some staff down-time. By assigning these staff to create User Documents you benefit from effective use of this down-time, and the employees benefit from experience in a new field.
These staffing benefits include:
* Use staff who may be idle between projects
* Your staff know the company’s culture and their fellow staff
* Your staff use existing company-wide writing tools (your word processor)
* No time needed to get oriented with the physical aspects of the job
* You have created a new resource within company
BENEFITS TO YOUR USER DOCUMENTS
If you have in-house writers (even if they are not formally trained as “technical writers”) you can just say “Sue, could you or Tom update the document where the sign-in window is presented.” Much faster and more flexible then having to go to an outside source. Sue and Tom have ownership of the document, and would work to improve it. They would use software resources available in your organization.
The benefits of in-house writers to your User Documents include:
* You can make corrections as you find the errors.
* You are able to update your User Document when you update your product.
* Better control of timing and resources
* No fear in dealing with the User Document in electronic form. From your word processor or add-ins, you can publish your User Document as a portable data format (.pdf) file, or as HTML for display on the Internet.
DOWNSIDES OF IN-HOUSE WRITING
The primary downsides of in-house User Document creation are the attitude and emotions of your newly-appointed writer. These include:
* Fear (“I don’t know how to write”)
* Anger (“Why me? This is unfair”)
* Uncertainty (“I don’t know what to write”)
* Isolation (“I’ve been cast into this writing thing”)
You can reduce these negative emotions if you encourage and support your New Writer.
SUPPORT YOUR NEW WRITERS
It is unfair to assign a non-writer to create a User Document without supporting him/her. You have to support your writer with:
* Training;
* Access to the development and marketing teams for product information;
* Use of the development team to evaluate their writing (small chunks);
* Access to the product, industry literature, and marketing materials;
* Style manual;
* Editor — your writing expert;
* Time to do a good job.
Other articles in this series (see the links in the “Resources” or “About the Author” section of this article) present more information about supporting your New Writer.
About the Author
Barry Millman, Ph.D., has a Bachelor of Science in Electrical Engineering (1966, Carnegie Institute of Technology) and an M.Sc. and Ph.D. in Psychology (Human Information Processing, University of Calgary). He has been a consultant for over 25 years, an instructor, course developer, and award-winning speaker. For the past seven years he has been researching and creating resources to help organizations create great User Documents.
Visit: http://www.greatuserdocs.com/ for resources to help you create the User Documents that your Product needs and your Users deserve.
Visit http://www.greatuserdocs.com/ReadingRoom.htm for more articles like this one.
Windows User’s Guide To Mac OS X Leopard
|
|
MOTOROLA ★ MOTORAZR V3 USER GUIDE ★ ENGLISH / SPANISH ★ Original ATT MANUAL 6/07 $6.99 |
|
|
Motorola LS750 Flex numeric Pager with manual,user guide $9.99 |
|
|
User’s Manual for Nfpa 921: Guide for Fire and Explo… $81.95 |
|
|
VINTAGE WESTON WX-7 35mm CAMERA & FLASH “ORIGINAL” OWNERS/USER’S MANUALS! $2.00 |
|
|
Canon SD780/ixus 100is Camera User Guide Manual in SPANISH with the box $7.99 |
|
|
NEW IDEA Elec1990 PAINT 5 1/4 disk and User Manual Vintage $14.75 |
|
|
Chrysler Navigation (RB4) User’s manual #81-170-04050 $29.95 |
|
|
BG008 1952 Chevrolet Chev Chevy Owner Manual User Guide $9.99 |
|
|
Nokia 2220 Cell Phone User Guide Owners Manual French Edition $5.00 |
|
|
KODAK DC210 DIGITAL PLUS ZOOM (NO CAMERA) ORGINAL BOX, USER MANUAL AND MORE $7.88 |
|
|
UTSTARCOM CDM8630AL CELL PHONE OWNER’S MANUAL/USER’S MANUAL ENGLISH AND SPANISH $1.99 |
|
|
Nokia 2220 Cell Phone User Guide Owners Manual English Edition $4.99 |
|
|
PASCAL: User Manual and Report by Niklaus Wirth and Kathleen Jensen (1975, Book) $0.90 |
|
|
1999 JEEP CHEROKEE Owners Manual User Guide $20.00 |
|
|
The Brain: A User’s Manual, The Diagram Group $1.56 |
|
|
1994 Jeep Wrangler Owners Manual and User Guide $29.99 |
|
|
SONY ERICSSON W350 USER GUIDE CELL PHONE MANUAL AT&T NR $2.99 |
|
|
Jetfighter II User Manual and Rare Hints Book-Velocity $6.99 |
|
|
2005 AGCO “GTA300 Mappin” USER’S GUIDE “GTA Suite Software” Manual $6.00 |
|
|
Hitachi/LG CD-R/RW Internal CD Writer ROM Drive ReWriteable With User’s Manual $19.99 |
|
|
Sem: A User’s Manual for Materials Science by Barbra L. Gabriel $14.95 |
|
|
1982 Dodge Truck Full Line Owners Manual User Guide Glovebox Operator Handbook $9.99 |
|
|
Parilla Leopard 125 cc TAG IAME Racing Kart Assembly instructions & User manual $24.75 |
|
|
W920-MC3A-8831 Watlow Series 920 User’s Manual $10.00 |
|
|
1990 Eagle Premier Owners Manual User Guide Glovebox Operator Handbook $19.95 |
|
|
Star Trek: 25th Anniversary (PC, 1992) with User Manual $10.00 |
|
|
1969 Ford GT350 GT500 Owners Manual User Guide Glovebox Operator Handbook $19.95 |
|
|
Mackie SRM450 Sound Reinforcement Speaker User’s Manual $9.00 |
|
|
Agilent HP E1355A E1356A E1357A E1358A Users Manual $25.00 |
|
|
Agilent HP E1361A Relay Matrix Switch Users Manual $20.00 |
|
|
Dell XPS M1530 User & Service Manual – PDF Download $5.00 |
|
|
Vintage Rollei Zoom-Rolleinar MC 80-200mm Lens Original User Manual West Germany $9.99 |
|
|
1966 PLYMOUTH FURY Owners Manual User Guide Glovebox Operator Handbook $9.99 |
|
|
1969 Oldsmobile 442 Cutlass F-85 Wagon Owners Manual User Guide Operator Book $9.99 |
|
|
1989 CHRYSLER CONQUEST Owners Manual User Guide Glovebox Operator Handbook $16.80 |
|
|
Conflict Catcher 3 v3.0.2 User Manual & 3.5 in. Floppy Disc in Excellent Shape $7.00 |
|
|
Agilent HP E1366A E1397A RF Multiplexers Users Manual $20.00 |
|
|
Agilent HP E1368A E1369A E1370A Modules Users Manual $20.00 |
|
|
1941 FORD V-8 V8 Owners Manual User Guide Glovebox Operator Handbook Instruction $9.99 |