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.
On 09/28/00 12:19 PM, rhoggan -at- lewis -dot- com (rhoggan -at- lewis -dot- com) wrote:
>>Humor in technical writing? No, don't do it.
>I agree completely. What might be funny to you, may be offensive to me. If
>your users need comic relief, they can turn on the TV set or go to a comedy
>act. Up to this point, I haven't found an employer that lets me spend eight
>hours a day watching television.
As with any other "hard and fast rule" about technical writing, the truth
is that it depends on your audience. If my audience is the same group
that is scarfing up millions of For Dummies books every year, I'd better
include some light-hearted or even mildly humorous references, or I'm not
serving my audience well.
The "Just Say No to Humor" rule can safely be replaced with "Use some
common sense, for goodness' sake." If you're dealing with a very serious
subject (warnings on avoiding brain damage, for example, or instructions
on how to handle the death of a loved one in your project planning
software), including humor is probably not the way to go. If, on the
other hand, you're telling people how to download the latest Metallica CD
in MP3 format, you pretty much have a joke in place already, so you might
as well finish it.
It all depends on your judgment, and the audience you're writing for.
Humor has its place in technical writing, as shown by millions of people
who pay real money for aftermarket documentation such as For Dummies and