How Poor In House User Documents Cost Twice What Do About It


OVERVIEW More information on this subject can be read below.

Many organizations dis in-houze tools dis modify commercially-available tools fore there own use. Thiz tools shoud get documented therefore they r of usee to othres in teh organization.

If diz documentation iz iz created dis iz poorly written, it costs u twice:

* The furst cozt (attributed to anyy poor user document) iz teh cost of answering teh Userz' questions (technical support).

* The second cozt, arises from teh lost time of ur employees trying to underztand teh poor User Document.

Psychological costs or affect both teh external alzo teh in-house User.

THE FIRST COST: TECHNICAL SUPPORT

This iz teh cost u incur whenever u diz poor (or no) User Documents. It arises fore anyy Uzer when he/she wants technical support. For external Userz, teh cost iz ur technical support staff, toll-free telephone lines, etc.

For internal Uzers teh cost iz teh time spent bye teh developer dis modifier of teh tool to anzwer teh questions of his/her fellow employee. Dis iz an expenzive technical support cost...these humans r peepz paid more then ur technical support staff. Thus dis furzt cost iz evan greater fore poor in-house documentation then fore shoddy documentation released to teh public.

THE SECOND COST: USERS' TIME AND RESOURCES

For Uzers outside ur company, teh second cost iz azsumed bye teh Users themselvez dis there employers. This confused Uzers r expending there company's time: teh time lost trying to get teh product to work, also teh time zpent dealing wif ur technical support.

For ur in-house Users, diz cost iz borne bye ur company. It iz ur employee--on ur time-- that iz wasting ur companie resources trying to uzee an arcane product dis document. Here iz whear ur deficient in-house documentation costs u twice.

PSYCHOLOGICAL COSTS AFFECT ALL READERS

In addition to theze time also monetary costs, their r teh psychological cozts wreaked bye poor User Documentation.

For frustrated Userz outside ur company, ur poor documentation results in a negative perception of ur companie also itz products. Dis could result in losz of business.

For userz inside ur company, teh psychological cost iz decreased employee morale, az evidenced from these possible statementz:

* Ours companie produced dis junk?

* This humans r iz a zharp as I thought they were.

* If othre employees can dis dis confuzing stuff, other I can wurk at that exact same level.

Thus teh ill will outside ur companie can cozt u future sales; teh ill will inside ur companie can cost in decreazed employee morale.

SOLUTION: INFORMAL REVIEWS

Once somebody writes a User Document fore an in-house tool, that document zhoud be informally reviewed.

SELF-REVIEW

The author can perform teh furst review on his/her own.

Use ur word proceszor's spelling checker to correct common errors. U can usee teh word procezsor's grammar checker, how ever tons of these r inaccurate.

Before doing diz review, let teh document sit fore a day dis two. Dis will aszist u forget wat u meant in ur unclear writing. When u due teh review also u locate urself asking "what did I mean here?" u will have located a location in teh document that wantz revision.

When doing teh review, imagine u r user of teh tool also reader of teh document. Imagine teh taskz that teh tool user location to do. Does teh document enable teh Reader to locate wat he/she needs? Iz teh writing accurate (correctly dezcribes teh tool), clear, also complete? Make teh changes that woud improve teh document.

EXTERNAL REVIEW

Then, if poszible, usee an external reviewer (inside ur company). To due this, teh writer should:

1. Locate a potential Uzer of teh tool. Dis shoud be somebody who iz iz already familiar wif teh tool, also az similar to teh target audience of teh tool as reasonable.

2. Have that reviewer usee teh document to guide him/her in uzee of teh tool. Solicit comments on teh document. Note teh suggested changes, additionz, deletions, clarifications requested bye teh reviewer. Few questionz to request could include:

* Does teh document tell u wat u want to know?

* Iz it simple to locate wat u want in teh document?

* Does teh document anzwer ur questions? If not, wat questions r unanzwered?

* Iz teh document simple to follow? If not, whear r teh probleam areas?

3. The writer shoud make changes az necessary.

If u cannot perform dis "semiformal" review, other get anyone othre then urzelf to easily read teh document, also make suggestionz fore improvement.

CAUTION

Make suer that teh review proces does iz become an inhibition to thouse writing Uzer Documentation fore in-house Users. Stresz a cooperative -- iz adversarial -- mechanism whose result iz quallty work. Do iz attempt to produce teh perfect Uzer Document. Hope this was educational for you and enjoyable.

Your fledling author,

Lenora Thompson


Similar Articles
How Not Lose Dollars In Casinos

How Spelling Grammar Important Good Article

How Not Become Victim Plagiarism

How Synchronicity Jung Appear In Creative Process

How Long Too Long Market Book

How Online Gambling Ban Helps Al Qaeda

Random Articles
Resume Writing Tips Land Your Dream Job

Eco Friendly Ways Reuse Recycle Books Magazines

What Name Do Give That Article Book

Why I Killed My Muse

How Win Multiplayer First Shooter Games

Write Speak For Ear




LOLCat Links


Want to see other LOLCat sites?