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


by Barry Millman, Ph.D. - Date: 2007-02-05 - Word Count: 564 Share This!

OverviewYour 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 MakerI 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 that described this object in the User Manual, or on the box, or any package insert .

I went back to where the coffee maker was, 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 BacklightMy 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 SwitchMost 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 DocumentationGreat 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

Source: Free Articles from ArticlesFactory.com


Related Tags: writing, let, features, your, products, great, flaws, technical, dont, become, expensive

Barry Millman, Ph.D., has a Bachelor of Science in Electrical Engineering (1966, Carnegie Institute of Technology) and a 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 content and access that your Users want and need.Visit http://www.greatuserdocs.com/ReadingRoom.htm for more articles like this one.

Your Article Search Directory : Find in Articles

© The article above is copyrighted by it's author. You're allowed to distribute this work according to the Creative Commons Attribution-NoDerivs license.
 

Recent articles in this category:



Most viewed articles in this category:


  • Don't Put Off Writing that Book! by Linden Gross
    If writing that book you've always had in mind tops your list of resolutions or regrets, hiring a wr
  • How To Write A Better Press Release by Brian Konradt
    A press release is the most effective way to generate free publicity for your business or organizati
  • Writing on the Hoof by Rick Chapo
    Finding inspiration when you are writing is often a haphazard affair. When you are physically ready
  • Focus On Nigeria by Andrew Sandon
    Focus on Nigeria Nigеria is a natural gas and oil rich country that is bordеrеd b
  • How to Write Great Dialogue in Your Book by Steve Manning
    Dialogue isn't so much read as it is heard by the reader. The eyes see the words on the page, the b
  • Women SUV Driver from www.thefrap.com by Eric Schmidt
    Why do so many women drive around in the oversized SUV's, the Tahoe, Excursion, Escalade
  • How To Write Good Articles by Jonathan White
    As a writer you may be ready to cash in on the need for web content. There is a lot of money that c
  • NEWS FLASH: Technical Communicator Saves World by Peggy Bennett
    I had a boss several years ago who was amused by my earnest and relentless preaching about the impor
  • Writers Resources by Josh Riverside
    Writers use certain inherent talents to come up with their pieces of writing. However, they do need
  • Popular Articles by Roel Sundiam
    Articles are those that are available in plenty these days in the internet. The articles are written