Victoria Real Estate Agency Home Sale Listings

How Poor In-house User Documents Cost You Twice & What To Do About It

OVERVIEW

Many organizations produce in-house tools or modify commercially-available tools for their own use. These tools should get documented so they are of use to others in the organization.

If this documentation is not created or is poorly written, it costs you twice:

* The first cost (attributed to any poor user document) is the cost of answering the Users' questions (technical support).

* The second cost, arises from the lost time of your employees trying to understand the poor User Document.

Psychological costs also affect both the external and the in-house User.

THE FIRST COST: TECHNICAL SUPPORT

This is the cost you incur whenever you produce poor (or no) User Documents. It arises for any User when he/she needs technical support. For external Users, the cost is your technical support staff, toll-free telephone lines, etc.

For internal Users the cost is the time spent by the developer or modifier of the tool to answer the questions of his/her fellow employee. This is an expensive technical support cost...these people are usually paid more than your technical support staff. Thus this first cost is even greater for poor in-house documentation than for shoddy documentation released to the public.

THE SECOND COST: USERS' TIME AND RESOURCES

For Users outside your company, the second cost is assumed by the Users themselves or their employers. These confused Users are expending their company's time: the time lost trying to get the product to work, and the time spent dealing with your technical support.

For your in-house Users, this cost is borne by your company. It is your employee--on your time-- that is wasting your company resources trying to use an arcane product or document. Here is where your deficient in-house documentation costs you twice.

PSYCHOLOGICAL COSTS AFFECT ALL READERS

In addition to these time and monetary costs, there are the psychological costs wreaked by poor User Documentation.

For frustrated Users outside your company, your poor documentation results in a negative perception of your company and its products. This may result in loss of business.

For users inside your company, the psychological cost is decreased employee morale, as evidenced from these possible statements:

* Our company produced this junk?

* These people are not a sharp as I thought they were.

* If other employees can produce this confusing stuff, then I can work at that same level.

Thus the ill will outside your company can cost you future sales; the ill will inside your company can cost in decreased employee morale.

SOLUTION: INFORMAL REVIEWS

Once someone writes a User Document for an in-house tool, that document should be informally reviewed.

SELF-REVIEW

The author can perform the first review on his/her own.

Use your word processor's spelling checker to correct common errors. You can use the word processor's grammar checker, however most of these are inaccurate.

Before doing this review, let the document sit for a day or two. This will help you forget what you meant in your unclear writing. When you do the review and you find yourself asking "what did I mean here?" you will have found a place in the document that needs revision.

When doing the review, imagine you are user of the tool and reader of the document. Imagine the tasks that the tool user wants to do. Does the document enable the Reader to find what he/she needs? Is the writing accurate (correctly describes the tool), clear, and complete? Make the changes that would improve the document.

EXTERNAL REVIEW

Then, if possible, use an external reviewer (inside your company). To do this, the writer should:

1. Find a potential User of the tool. This should be someone who is not already familiar with the tool, and as similar to the target audience of the tool as reasonable.

2. Have that reviewer use the document to guide him/her in use of the tool. Solicit comments on the document. Note the suggested changes, additions, deletions, clarifications requested by the reviewer. Some questions to ask might include:

* Does the document tell you what you need to know? * Is it easy to find what you need in the document? * Does the document answer your questions? If not, what questions are unanswered? * Is the document easy to follow? If not, where are the problem areas?

3. The writer should make changes as necessary.

If you cannot perform this "semiformal" review, then get anyone other than yourself to simply read the document, and make suggestions for improvement.

CAUTION

Make sure that the review process does not become an inhibition to those writing User Documentation for in-house Users. Stress a cooperative -- not adversarial -- mechanism whose result is quality work. Do not try to create the perfect User Document.

Barry Millman, Ph.D., has a Bachelor of Science in Electrical Engineering and an M.Sc. and Ph.D.in Psychology. 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.

MORE ARTICLES:

American Muscle Homes for Our Troops Charity Event July 21st
American Muscle will be donating 5% of every order we receive between 10 a.m. and 4 p.m. EST on Saturday, July 21st, 2007 to Homes for Our Troops. Homes for Our Troops is a non-profit organization dedicated to helping military members who have selflessly given to our country. Show your support for our troops and do your Ford Mustang Parts shopping during those hours.

Leveraging the SuiteFlex Platform, Suite Business Software Connects NetSuite with QuickBooks POS for Retail Point-of-Sale
Suite Business Software, Inc. today announced that it has extended NetSuite's® One System Architecture with new capabilities to meet the needs of businesses in retail point-of-sale. With Suite Business Software's QuickSuitePOS? retail point-of-sale integration, NetSuite customers can use QuickBooks POS at their retail locations and use NetSuite for their corporate system of record. This extension pulls data from QuickBooks POS into the full-featured NetSuite web-based system.

Real Estate Appraisal - Do It Yourself
For single family homes, there are two basic methods used in real estate appraisal. They are replacement cost analysis, and using comparable sales.

On July 30th, Underground Strength Coach Gym of Edison, NJ Holds First Ever Open House
On July 30th, Underground Strength Coach Gym of Edison, NJ Holds First Ever Open House Featuring Surprise Give Aways, Feats of Strength Demonstrations and Free Refreshments. The USC Gym is an athletic development facility which is unlike any other gym around the world. On any given day you might find athletes flipping 500 lb. tractor tires, dragging sleds across the parking lot that weigh 500 lbs or exercising with stones and sandbags.

Bargain Network Offers Ideas For A Successful Open House
Bargain Network is the nation's leading source for great deals on real estate and cars.

International Design Award Spotlights Leading Thai Branding and Advertising Agency
Midnite Oil Design, a leading Bangkok branding consulting and advertising agency, has received the Spark Awards medal for graphic design for its iconic "drop of oil" logo.

Jump on Your Skis and Search the Mountain as New Belgium Brewing Hosts Its Annual Taos Scavenger Hunt
A Day of Downhill and Clue-Finding Raises Money for Charity: New Belgium, makers of Fat Tire Amber Ale and other Belgian-inspired beers, is once again bringing the clues and frosty brews to Taos Ski Valley in New Mexico for the 2nd Annual New Belgium Scavenger Hunt on March 15.

Choose the Right Agent in Selling Your Home in Siesta Key Real Estate
Selling your home in Siesta Key real estate can be stressful since it is a huge undertaking that you can do in your life. If you will be doing wrong choices, you will make things worse and you wont be able to sell your home quickly and with the best deal.

Real Estate Brokerages Folding Up, Local Superstars Set Up BlueStar Funding Group
Highly talented mortgage originators form new company.

Guide To Online Dating Agency
Online dating agency is one of the rare Internet businesses that really bring in money and has taken the lead as far as content business goes. While other internet or online business has been sputtering over the years, the online dating agency sites are making a killing. The phenomenal growth of this online dating agency industry is attributed to the popularity of the internet and the continuous quests for companionship and love. Online dating agency addresses an essential need. And the fact that it is so easily accessible makes it even more attractive. Hence, the reason for its popularity. There are hundreds of online dating agency and relationship-oriented websites which are complimentary businesses supporting the new online dating agen...

"The Secret" ... 7 Simple Steps To Wholesaling Real Estate For Huge Profits!
I am constantly asked about my secret sauce How are you consistently finding real estate wholesaling deals

New Technologies Simplify The Way Consumers Purchase Term Life Insurance!
Today's' savvy consumers with their busy, on the run lifestyles may not find it possible to commit to an appointment with an insurance agent for basic mortgage protection or term life insurance. Even though every married couple or family should have some basic form of protection in place to cover against a tragic loss or sickness, many avoid putting it on the top of the to-do list due to simple inconvenience. Considering these obstacles regarding protecting your family against loss, how can technology improve a consumers buying experience and shorten the application process?

Writing Sales Letters That Sell
The most important part of any marketing you do is direct marketing. This includes letters, postcards, brochures, newspaper or magazine coupons, telemarketing, TV or radio direct response commercials, e-mails, and the copy on your web site.

How to Make Money in Commercial Real Estate
Hi, this is Emil from http://investing-in-propertycom