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:Robert Plamondon <robert -at- PLAMONDON -dot- COM> Date:Tue, 21 May 1996 07:31:46 PDT
There's a difference between choosing a humorous guide to a product
and having one inflicted upon you. For ships-with-the-product
documentation, any humor would be corraled into footnotes, italicized
chapter prefaces, sidebars, or other traditional places for semi-
extraneous matter. This separates the fun stuff from the serious
stuff, and you'll find that users will often go through the book
reading the fun stuff before they tackle the nasty technical stuff.
This is an old gimmick for reducing the threat level of textbooks.
(My high-school geometry book was perfectly straightforward, except that
it was filled with more-or-less relevant comic strips, and that, instead
of labeling all the points in the sequence [A,B,C,...], the points always
spelled out something strange.)
Robert Plamondon, President/Managing Editor, High-Tech Technical Writing, Inc.
36475 Norton Creek Road * Blodgett * Oregon * 97326
robert -at- plamondon -dot- com * (541) 453-5841 * Fax: (541) 453-4139
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