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:Using Humor Judiciously From:William=E -dot- =Newkirk%Pubs%GenAv -dot- Mlb -at- RODES -dot- CCA -dot- ROCKWELL -dot- COM Date:Wed, 22 May 1996 09:32:42 EDT
some places where humor seemed to work:
Signetics 555 and derivative application manual (with the little man
alternately announcing some design guidepost and then being taken down a
notch when an alternate configuration solved a problem - such as driving
inductive loads and the 50% duty cycle problem (the standard equations for
the standard timer circuit come up with impossible parts values)).
Sony's book on digital audio (forget the real title) that used cartoons to
show an "army" of data bits being shuffled around for preparation in use on a
CD...(addition of error detection/correction bits plus the checksums and
humor can also be used to check to see if the reviewers are paying attention.
a predecessor here had a procedure for cleaning a device. this procedure
required baking the parts after cleaning to remove the last traces of
solvent. in the procedure, he'd written "After cleaning, bake the movements
in an oven at 350 deg F for 15 minutes or until the crust is golden brown".
None of the reviewers caught it, nor the editors - he'd had them fix up the
procedure before printing but kept the typesetter output page.
wenewkirk -at- rodes -dot- cca -dot- rockwell -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