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.
I've been asked to explain how I came up with the figure that 90%
of all an-line help produced since 1995 would fail a rigorous
First, the 90% figure is probably charitably low. I doubt if 10% of those
working on on-line help have any concept whatsoever of what a real hypertext
should be, much less how to create one.
A huge percentage of all on-line help follows the miserable Microsoft/WinHelp
model, where the user is initially presented with an index of keywords.
By typing a word or phrase into the slot provided, the user is presented
with the matching keyword, and by clicking on that, the help on that
subject is presented. Based on my own experience, my guess would
be that systems based on this approach fail to deliver the correct help
page more than 50% of the time, and in the cases where the correct
help page is presented, it fails to provide the user with the information
(s)he's looking for about 40% of the time. Any on-line help system with
numbers like that is an utter failure in my opinion.
The new Microsoft help technique (probably developed after the
realization that the approach described above was an abject
failure) utilizes a "Wizard" that is supposed to anticipate what
the user is thinking at each moment, and deliver help based
on that Bayesian conclusion. Guess what I think of that approach.
The whole concept of a real hypertext is to put the reader in the driver's
seat, allowing him/her to efficiently wander wherever (s)he thinks
a nugget of information may lie. This requires that the user form a
mental model of the knowledge base, and is provided with adequate
navigational aids. Neither of the approaches described above
allow a mental model to be formed, neither provides adequate
navigation aids, and neither puts the reader in the driver's seat.
| Nullius in Verba |
Dan Emory, Dan Emory & Associates
FrameMaker/FrameMaker+SGML Document Design & Database Publishing
Voice/Fax: 949-722-8971 E-Mail: danemory -at- primenet -dot- com
10044 Adams Ave. #208, Huntington Beach, CA 92646
---Subscribe to the "Free Framers" list by sending a message to
majordomo -at- omsys -dot- com with "subscribe framers" (no quotes) in the body.