iSnare.com - Free Content Articles Directory
Authors Contents [Advanced Search][Add OpenSearch][Job Search]
Distribute your articles to thousands of article sites for only $2 and below! Read more...

Index  Writing
 

Great Technical Writing: Don't Let Your Product's Features Become Expensive Flaws

 
[ Contact the Author] [ Send to a Friend] [ Article Publisher] [Make PDF] [ Print] [ Bookmark & Share]
 
Read our Terms of Service before reprinting this article. The submitter specified above has claimed the rights to this article.
Barry Millman

Overview

Your product's unexplained features can turn into costly flaws. This article describes three real-world products with just such "features." It presents ways you can prevent these feature-to-flaw conversions by improving the User Documentation for your products.

Examples

1. A Wand that Came with a Coffee Maker

I got a fancy electric coffee maker. In the box was a strange, and unexplained, object. It looked like a white plastic spoon, but where the bowl of the spoon should be was a mesh bag with something inside it. It did not seem to be made to assemble into the coffee maker.

There was nothing in the User Manual, or on the box, or any package insert that described this object.

I went back to where the coffee maker was bought, and asked about this object. The shopkeeper phoned the company, and later got back to me.

How much would we estimate the calls cost? Why did this time and money have to be spent?

(The device was a water filter. The User is to stir it in the water before making the coffee...it's supposed to remove impurities.)

Solution: Attach a tag to the wand. On the tag, explain what the wand is, its benefits, how to use it, and (in a nod to marketing) where to purchase more.

2. MP3 Player Backlight

My MP3 player has a backlight that illuminates when you press any button on the player. It has a nice, battery-saving feature, also. When the battery level drops below a preset amount, the backlight on the player will no longer come on. Excellent design idea.

A new User plays the MP3 player for a few hours, the battery runs down, and the backlight no longer works.

Unfortunately, the battery-saving feature is not documented. Even if the User searched the documentation, this feature would not be found.

The User's point of view can be summed up by one question: "How come my backlight no longer works?"

Followed by an action plan:

. "I'll call technical support."
. "I'll return this defective product."

Are these action plans not expensive to the company?

Solution: Mention this backlight behavior both as a feature (perhaps in the discussion about battery life) and also in the troubleshooting portion of the User Document.

3. Hold Switch

Most portable electronic devices have a "hold switch." This is a switch (or button combination) that locks the device so its controls cannot accidentally be activated. Feature.

It is quite possible that the hold switch can get accidentally moved to the "hold" position. Now none of the controls on the device work. The User, who may have never heard of the hold switch, is now faced with a "defective" product. Expensive Flaw.

. How many technical support calls have been made because of a hold switch?
. How much stress was created by these "defective" products (even if the User did eventually figure out about the hold switch).

Solution: Describe the Hold Switch both as a feature (where you discuss the controls on the device) and also in the troubleshooting portion of the User Document.

Great User Documentation

Great User Documentation provides the information that your Users need, and the means to effectively access that information, finding what they need, and skipping over what they don't.

Great User Documentation creates Users who are effective and comfortable with your products. These Users:

. Recommend your product to others
. Cost your organization less (reduced product returns and fewer technical support calls)
. Will buy your products in the future

Important NoticeDISCLAIMER: All information, content, and data in this article are sole opinions and/or findings of the individual user or organization that registered and submitted this article at Isnare.com without any fee. The article is strictly for educational or entertainment purposes only and should not be used in any way, implemented or applied without consultation from a professional. We at Isnare.com do not, in anyway, contribute or include our own findings, facts and opinions in any articles presented in this site. Publishing this article does not constitute Isnare.com's support or sponsorship for this article. Isnare.com is an article publishing service. Please read our Terms of Service for more information.

Barry Millman, Ph.D., 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/
Article Tags: user [See Dictionary], hold [See Dictionary], switch [See Dictionary]
Got a question about this article? Ask the community!
Article published on October 02, 2006 at Isnare.com
 
Rate [Ratings: 5 / 5] [Votes: 1]

Great Technical Writing: The User-Product Life Cycle - A Documentation Tool
Submitted by: Barry Millman

The User-Product Life Cycle (U-PLC) is a powerful tool for the User Document writer Use the U-PLC to generate the high-level topics for your User Document...

Great Technical Writing: Tell Your Users What To Expect
Submitted by: Barry Millman

OVERVIEW In your User Documentation, you direct your Reader to perform tasks with your product If you don't tell your Reader what to expect when performing those tasks, you will have a baffled Reader, resulting in dissatisfaction and expensive calls to technical support...

New Technical Writer: Have No Fear Of Writing
Submitted by: Barry Millman

OVERVIEW You're a non-writer who has just been assigned to write the User Documentation for your company's new product...

How Poor In-house User Documents Cost You Twice & What To Do About It
Submitted by: Barry Millman

OVERVIEW Many organizations produce in-house tools or modify commercially-available tools for their own use...

Great Technical Writing: User Document Headings Should Be Guideposts, Not Advertisements
Submitted by: Barry Millman

OVERVIEW Most heading are designed to entice us to read further Headings in User Documents should enable your Reader to decide whether or not to continue reading that section...

Great Technical Writing: Improve Your Readers' Access With A Visual Index
Submitted by: Barry Millman

OVERVIEW People are visual creatures They look at your product, and see, for example, a button or display...

Benefits Of Creating User Documents In-House
Submitted by: Barry Millman

OVERVIEW For small companies, creating their product's User Documentation in-house, provides benefits to the company, to (idle) staff, and to the product...

New Technical Writer: Avoiding The Interview-writing Disconnect
Submitted by: Barry Millman

OVERVIEW Lost or garbled information is a terrible waste Especially if it's the information you gathered from an interview and must now write into your User Document...

New Technical Writer: Don't Confuse Your Reader With Your Words
Submitted by: Barry Millman

OVERVIEW Stop confusing your Reader with the words you use Your Reader is trying his/her best to understand how your product works without having to figure out your writing...

Great Technical Writing: Improve Document Searches
Submitted by: Barry Millman

OVERVIEW Searches in User Documents (manuals, etc) often fail because the Reader uses different words for a concept than the author uses...

New Technical Writer: Use The Persona To Create The Most Useful Section Of Your User Document
Submitted by: Barry Millman

OVERVIEW A good User Document includes sections on how to set up, use, and care for the product However, to create a great User Document , the technical writer should use the Persona, generated in the analysis of the User/Reader, to create the topics for the most useful section of the User Document...

New Technical Writer: The Four Dimensions Of Your User/reader
Submitted by: Barry Millman

OVERVIEW To create an effective User Document, the writer must know who he/she is writing for This article presents four dimensions (Skills, Attitude, Knowledge and Experience) for describing the User of your product (your Documentation Reader), and how to build a Persona that turns your generic User into an almost-real person...

Great Technical Writing: Make Your Product Fit
Submitted by: Barry Millman

OVERVIEW Most product documentation sounds like their product is the only thing in the User's life Such thinking results in User confusion and dissatisfaction...

New Technical Writer: First Things To Do On The Project
Submitted by: Barry Millman

OVERVIEW You, a non-writer, have just been assigned to write the documentation for a product your company produces or markets...

Great Technical Writing: Sell Your Readers On What's Important
Submitted by: Barry Millman

Overview Our humdrum, sterile headings and writing manner do little to encourage our Users to read parts of the product documentation that would be especially beneficial for them...

Qualities of a Well-Written Short Essay
Submitted by: Mary Simmers

Have you been on writing an essay Usually, an essay is based on the writer’s point of view...

Press Release Writing Tips
Submitted by: Jason Kay

Writing a press release for dissemination to various media sources can be a great way to gain exposure for your company, your website, or a new product that you are selling...

Writing an Essay For Your College Application
Submitted by: Mary Simmers

Students nowadays are not that serious in listening to their English courses Oftentimes, they feel bored about the subject...

Things to Do When You’re Revising
Submitted by: Mary Simmers

When writing, it’s always prudent to allow plenty of time for revision When you’re done writing with the piece you are aiming to have...

How to Write in an Organized Manner
Submitted by: Mary Simmers

Needless to say, sometimes a writer feels uneasy especially when he/she is sitting on the chair for almost 8 hours or more doing nothing but to write an article...

How to Edit Phrases and Sentences For Conciseness
Submitted by: Mary Simmers

For some reasons, many people like to write what their minds and feelings portray Especially those writers who are to write on their not just because they were told to write or that it is their duty or requirements to write...

How to Use Adjectives and Adverbs
Submitted by: Mary Simmers

As a writer, we must be knowledgeable enough to know and determine all the parts of speech The most common are the nouns and pronouns which we commonly use these two as our subject in a sentence...

Your Audience and the Level of Formality in Your Writing
Submitted by: Mary Simmers

If you are into writing, you should know the flow of your piece If you are writing news story, reports, thesis, reviews, presentations and speech then you should aim a formal and piece of work...

Why You Should Work Hard on Your Scientific Abstracts
Submitted by: Mary Simmers

Good science is only one half of a scientist’s work; the other half is about communicating those results to other people...

Word Interrogation: Why It’s an Inefficient Way to Edit Your Writing
Submitted by: Mary Simmers

There are a lot of important things that needs attention when someone is going to start writing a piece...

10 Tips For Copywriting Success
Submitted by: Enzo F. Cesario

While video and multimedia technologies are rapidly expanding, the Web remains a largely a text-oriented system...

Starting a Piece in the Thick of the Action
Submitted by: Mary Simmers

Some topics work best when presented in a formal manner, easing the reader into the subject by a subtle introduction and expanding as they go further...

Ebook - Writing Skill Tips
Submitted by: Roberto Sedycias

Having knowledge on many subjects and passing it on in some type of media, paper book or ebook, will certainly be beneficial to others, but this requires proper tact and skill of putting the words together...

How to Create Your Own “Dictionary “
Submitted by: Mary Simmers

I last talked in an article awhile ago about making your very own personalized “dictionary “ Now I am not talking about inventing new words, what I am talking about is having your very own word reference...

Article Spinning 101: The Basics
Submitted by: Mary Simmers

Article spinning is becoming a popular demand in the world of Internet Marketing nowadays Never heard about it...

Isnare.com Footer Divider

© 2004-2009. Isnare Free Articles - An Isnare Online Technologies Free Articles Project. All Rights Reserved.   Privacy Policy