Printer Friendly

The role of humor in documentation - or - laughing 'til it bytes.

Pity the poor tech writer. We have been called many things by readers immersed in the murky waters of the typical computer software manual, but fascinating isn't likely to be one of them. To counter this prejudice of tedium that most people seem to assume is the essence of technical writing, we have been positively shameless in the attempt to enliven our art. We appeal to their senses as well as their intellects. We plan copious white space, and direct them hither and yon with cunning mauve arrows. We deck our paragraphs with icons so that everyone can follow the thought. All of these devices are worthy, and have contributed to documentation becoming more accessible, readable and effective prose. Yet, despite these efforts and improvements, software documentation maintains the most devastating reputation: that of utter dreariness.

Why is that? Why in order to learn anything from software documentation does one need the attention span of a sphinx? Concurrently, why is it that any lengthy exposure to a user guide is practically guaranteed to reduce the reader to the mental state of an artichoke? In other words, why is documentation so boring?

Why does it seem to be so internally difficult to make technical manuals both informative and interesting? The problem is engineered One reason surely is that writers and designers face problems that up to now have been generally ignored. Among obstacles too numerous to catalogue, the primary difficulty may be that most software is designed by engineers. Self-evident, but contrary to assumption, engineers are not human. They belong to a sub-species, Homo Obscuro. It has been discovered that they comprehend the world differently from regular people. To demonstrate this problem, Prof John Wyatt, of MIT's Department of Electrical Engineering and Computer Science, has systemized what a typical engineer might think were some good rules for user documentation:

Rule 1. No one learns by doing.

Rule 2. Think like a machine: Do everything in binary.

Rule 3. Anybody who wants to know anything wants to know everything in equal detail.

Rule 4. No one ever wants to do just a few simple things with software.

Rule 5. If the reader is not familiar with all previous generations of the product in intimate detail, he or she has no business reading the manual.

Rule 6. An underdeveloped strategy for documentation is the use of accusations and threats.

Rule 7. Plain-language descriptions are always insufficiently precise.

Rule 8. Any user-oriented computer language is merely a tool to obscure the real action going on at machine code level.

Rule 9. You might think that manuals exist to inform the user. You're wrong. The real purpose of the manual is to record the design history of the software for the engineers. So, for each feature you should include a detailed account of all competing features which were rejected in the final design review.

The fact is, documentation, like the engineer, deals with something that has one essential mandate: to work. However, often that seriousness of purpose translates to a heaviness of approach. What's so funny? A friend recently remarked that most of the humor presently found in technical documentation is entirely accidental. However, the deliberate use of humor by technical writers can add immeasurably to the effectiveness of material whose only real purpose is not to be savored, but to serve.

Perhaps a primary point to consider is just exactly what is humor? E.B. White said, "Analyzing humor is like dissecting a frog. Few people are interested and the frog dies of it."

Also, what may be utterly hilarious (or even mildly amusing) to one person may be inexplicable or even offensive to another. The global community has become both increasingly diversified and interconnected. Nevertheless, different cultures answer the question 'What's funny?' in radically different ways.

A few years ago I was teaching a class in cartooning at MIT to a group of graduate students and visiting scientists. Since eight Asian and European nationalities were represented, my initial exercise was to find out what students found funny.

I brought Gary Larson cartoons to class. Although the different cartoons elicited various responses, in general everybody was amused, except for a visiting scientist from Osaka. He just didn't find the material humorous, and he decided it was because he was Japanese.

I asked him to describe a situation that people in Japan would find funny. He mulled it over for a minute and then said, "A funny scene would be a group of pedestrians at a stop light, and even though the light was red, the whole group was crossing the street anyway!"

None of the rest of us in the class considered the anecdote a knee-slapper, but we understood what he meant. His example also illustrates that while "funniness" has a definite cultural component, the urge to perceive and respond to humor is universally human.

Humor is the bounding of things by extremes. Nevertheless, those extremes must be carefully drawn. One critical element of the effectiveness of humor is appropriateness, both of context and' intent.

Documentation fulfills a necessary and serious function: instruction about serious, and often expensive, technology. Humor must enhance, not obscure; unlike its role in some forms of prose, it does not exist in documentation for its own sake.

Perhaps no one can answer the question: Why is something funny? But humor works by creating identification, sometimes to an absurd degree. It arises when differences are perceived in things that are apparently similar, and likenesses in the dissimilar. Within that tension is laughter, and ultimately, understanding. Use humor to advantage The use of humor as part of the text gives a document several advantages. It suggests that the writer and designer are genuinely engaged with the subject, always an attractive notion. It contributes to a less forbidding learning environment; perhaps most of all, it provides the element of surprise. Something perceived as dull is concurrently considered predictable. Readers will pay active attention to material that incorporates humor, if for no other reason than they don't know what to expect next, and this confoundedness in turn encourages real learning.

However, one shouldn't go overboard. With humor, as other things, excess zeal is generally regrettable. For example, beware of the injudicious use of parentheses. For example, suppose you are describing part of a word processing program that deals with moving blocks of text. Never tell your reader to highlight the text and press the delete key, and then finish your instructions with the parenthetical remark (just kidding!). A corollary to that axiom is: Never write critical information, such as operating instructions, in the form of a parody. Finally, in technical documentation the effectiveness has not yet been determined of using scratch 'n' sniff patches.

When humor is made an intrinsic verbal or graphic element in a tutorial, the benefits can be even greater. Most documentation exists to teach the reader how to use the product. Thus the effectiveness of user guides can depend on the reader's willingness to work through examples. Unfortunately, examples are generally so tedious that most users would rather stumble about the program, depending upon unreliable intuition, than slog grimly through the tutorial. The result, at best, is a user who has only an imperfect and sometimes incorrect understanding of the product's use and potential. At worst, it is what keeps technical support people so well-employed. Hard work is doubtless a virtue if you're a football player, but documentation is more like catching flies: A little sugar may snag more end users.

Obviously, humor is not a substitute for detail and accuracy; a humorous approach can and must be as rigorous as an astringent one. However, humorous examples give the reader a double payoff: necessary information about the product as well as a real-time good time. When the process itself is pleasant and rewarding, the result, in this case the assimilation of information, is equally enhanced.

Perhaps the most effective, and least intrusive, way of including humor is the use of whimsical illustrations and/or cartoons. The nature of a cartoon is to reduce a situation to its essence. Of the various devices for humor, cartoons allow one to exercise the least degree of restraint. You can say things with a cartoon that would be positively dangerous to include in the text. Cartoons also can be an effective way of making a point by declaring its opposite. Perhaps most important, cartoons lend a we're-all-in-this-together feeling to a document: Misery loves knowing others are out there equally mired.

Humor can leaven documentary hardtack into a substantial loaf delicious as well as nourishing. Humor relaxes resistance. It encourages memory by creating pleasant associations. And while it perhaps cannot shorten the learning process, it can contribute to reducing the perception of toil, which may result in a reader who is more receptive to continuing to learn. Perhaps most important, humor reaffirms that we are, after all, humans and not machines, and that the best approach to any endeavor is one that engages our whole selves. Wiiter/cartoonist Peaco Todd is a partner of Bradley/Todd Words & Pictures, a Cambridge, Mass., company offering writing, design and other communication services.
COPYRIGHT 1991 International Association of Business Communicators
No portion of this article can be reproduced without the express written permission from the copyright holder.
Copyright 1991, Gale Group. All rights reserved. Gale Group is a Thomson Corporation Company.

Article Details
Printer friendly Cite/link Email Feedback
Title Annotation:technical writing
Author:Todd, Peaco
Publication:Communication World
Date:Nov 1, 1991
Previous Article:How to communicate to a post-literate world.
Next Article:How 14 association publications make money.

Related Articles
An exploration of the social functions of humor among college students in wheelchairs.
Was that really funny?: the politics of humor.
I'll laugh tomorrow.
Medicinal mirth gets research rebuke.
The Webhead report fun intended.
Seinfeld, The Simpsons spark same nerve circuits. (The Brain's Funny Bone).
The healing power of laughter: liberal doses of humor are a proven prescription for wellness. (Attitude Enhancement).

Terms of use | Privacy policy | Copyright © 2021 Farlex, Inc. | Feedback | For webmasters |