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.
Scott Goodhue (sgoodhue -at- disclosure -dot- com) asked about
choices for best manual we've ever seen. The manual
that initially inspired me to be a technical
communicator was the user guide for my Hewlett-
Packard 34C calculator (ca. 1979).
I was an aerospace engineer undergraduate and
needed an engineering calculator. The HP34C was
state-of-the-art, and intimidating to look at as
well.
The user manual was a small, wire-bound document
alive with vibrant, color illustrations. It was
very easy to look at and not at all intimidating.
The calculator worked great. And when it broke
down--I used it heavily--HP fixed it at no charge,
returning it to me quickly (1 week turnaround),
and even included a newly designed keypad. HP
charged it as a warranty repair even though the
warranty had recently expired. I used the
troubleshooting part of the manual to determine
that I needed to send it to HP for repairs.
The calculator displayed an error code that I
looked up in the manual. No problem: the
calculator told me what was wrong with it and
the manual provided the translation.
The manual was so good that I learned how to
solve many kinds of problems: finance, fluid
flow, statistical analysis, as well as other
typical engineering problems.
Ever since that manual, I have been a big fan
of Hewlett-Packard, of technical communicators
who do good work, and of the companies who
support that good work.
-Mike Uhl (uhl~m -at- glaxo -dot- com)
Glaxo Wellcome
Research Triangle Park, NC