TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: What *is* user friendly... From:Kent Newton <KentN -at- METRIX-INC -dot- COM> Date:Tue, 23 Jan 1996 12:29:00 PST
rjl -at- bostech -dot- com wrote:
-- snip --
>I tend to agree with WandaJane. For me, the term "user friendly" simply
means
>"easy to use." A document does not have to contain cartoons, smiley
faces,
>or pointing characters in order to be easy to use. In fact, as we all
know,
>a manual could be -loaded- with these things yet still incomprehensible
and
>useless for explaining procedures.
>Sure, it's nice to have Dilbert supply a joke on the page, but when it's
late
>at night and I'm trying to figure out how to get an obscure feature to
>work, I don't need humor. I need short, accurate, well-written steps
that
>tell me exactly what I need to know. I don't need a wacky index, I need
>a nice, thick, clearly written index that links back to headings that
match
>the feature names.
>And I'd like the documentation to explain as much as possible about all
the
>features. A smiley-book that gives me only the basics is likely useless,
>can figure out how to open, rename, and save files. Instead, tell me
>-everything- that the system will do. Doggone it, I -paid- for those
features
>and I expect some sort of explanation of how to use them.
For advanced users, the smiley faces and pointing characters are a
distraction and the entry-level content is insufficient to meet the
needs; but for the novice, they might be exactly what are needed. On the
other hand, no matter how clearly organized the index, how simple the
steps, or how detailed the feature descriptions, an advanced manual will
only confuse a novice. So, there is no single definition for "user
friendly": it depends on who the user is. One of the keys to effective
documentation is "Know your audience."
Kent Newton
Senior Technical Writer
Metrix, Inc.
kentn -at- metrix-inc -dot- com