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:Usability (Was: What's it called?) From:Mark Magennis <markmagennis -at- YAHOO -dot- COM> Date:Thu, 6 May 1999 01:52:50 -0700
John Posada's instructions include the following line:
Step 1: In the directory C:\Program\<ApplicationName>, you will
find a file named mdac_typ.exe.
I recently introduced a company-wide standard for documents,
faxes, and letters, using Word templates and a written guide.
The guide included some instructions similar to John's. It
wasn't until I carried out a usability test that I realised that
some users have the Windows folder option "Hide file extensions
for known file types" checked. In John's case, those users
wouldn't see any .exe extensions. In my case, users were
confused because they couldn't see .doc and .dot extensions.
This caused them very real problems and reduced ther faith in
This experience illustrates why usability testing of
instructions is so useful. It's not just about uncovering
configuration problems either. I could tell a dozen similar
stories about problems that arose from differences in
interpreting words and concepts, differences in prior knowledge
and experience, even differences in attitude. None of these
problems were anticipated when I created the materials. All
could be alleviated by changes to the templates and guide.
I was quite astonished at how many serious usability problems I
uncovered. My usability test produced 63 concrete
recommendations for improvements, some of which meant huge
changes. As a result, what we now have is widely regarded as
easy to work with. I feel sure that without the usability test
the whole standardisation attempt would have failed.
Mark Magennis | Technical Author
FM Systems Ltd. | Information Developer
Leopardstown Office Park | Tel: +353 (0)1 295 2549
Foxrock, Dublin 18 | Fax: +353 (0)1 295 2554
Ireland | markmagennis -at- yahoo -dot- com
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com