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.
Subject:Re: Using Humor Judiciously From:Len Olszewski <saslpo -at- UNX -dot- SAS -dot- COM> Date:Mon, 20 May 1996 19:48:15 GMT
In article <Chameleon -dot- 960520140641 -dot- ejray -at- ejray -dot- ionet -dot- net>, Eric Ray
<ejray -at- IONET -dot- NET> writes:
|> I know I'd rather have some humor in a book I
|> buy, but wouldn't want it in the "documentation"
|> for a product. What do the rest of you think?
That's a good yardstick; keep it out of primary product doc. Aside from
being hard to translate mechanically, humor plays in radically different
ways to different cultural or ethnic groups, so you are on shaky ground
if you ship your doc internationally. And humor also strikes a lot of
people differently even in the US. Why risk annoying your customers?
Discretionary books are a different story. You don't have a "captive"
audience like you do for primary doc. Be as funny as you want there;
people who dislike your humor just won't buy your documentation. And
when they don't, your humor might not seem as funny as it did when you
I like humor. However, I would look very closely at including it in
technical material of any kind. There is very little to gain in clarity,
and lot of risk to your commerce.
Len Olszewski My opinions; you go get your own.
saslpo -at- unx -dot- sas -dot- com
Post Message: TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
Get Commands: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "help" in body.
Unsubscribe: LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU with "signoff TECHWR-L"
Listowner: ejray -at- ionet -dot- net