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.
As reported in the STC magazine a few years ago, humor in a computer manual led
to a death and a law suit. In this case the computer manufacturer created a
humorous guide to how to connect your computer and all of the peripheral stuff.
In this case some empty-headed degenerate jammed a screwdriver into the case and
electrocuted their sorry a**. It all went to hell when the lawyers got involved.
The bottom line that came out in the court proceedings was that by using humor
the manufacturer gave the impression that there was nothing dangerous. The humor
"lulled" the user into a disregard for safety, or some such. You can search the
STC archives and can probably find the story.
Another example is that what I think is funny, Jim or Jane Lunchbox does not. I
find some examples of humor condecending. That is why I only own one "Dummies"
book (FrameMaker). When I pick up a manual, reference, or text, it is because I
want (need) to find out something. I hate it when I have to sift through some
useless humorous drivel to get to the information I am looking for.
Ask your corporate lawyer, ISO auditor, QA/QC person, or safety person, if they
think you should use humor. Wanna guess their answer?
Bottom line: DO NOT USE HUMOR IN TECHNICAL WRITING.
Senior Technical Writer
Integrated Measurement Systems, Inc.
Phone: (503) 469-3615
Email: bkieffer -at- ims -dot- com