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: Humor as a communication technique -Reply From:Lisa Higgins <lisarea -at- LUCENT -dot- COM> Date:Tue, 16 Jun 1998 11:23:21 +0000
Lisa Comeau wrote:
> but only because she refers to 'angry docs', and I believe that
this is the type of documentation we want to aviod
anyway. To me, the term 'angry docs' refers to those
"non-user-friendly" docs we di>
No, no, no. The documents themselves are not 'angry.' I'm talking
about the sort of stuff where the users are likely to be angry and
impatient. This includes stuff like help files and, in many cases,
user manuals. You do need to know your audience, and if your audience
only turns to certain documents when they've tried everything else,
you MUST write as though the users are in a hurry.
It's all well and good if you want to put the cute stuff or the
background information in another place, but if I, as a user, am
trying to complete some task and I can't figure out how to do it, the
first and only thing I want to see when I click that help button or
open that manual is the procedure for doing what I want to do. It is
our job to try to predict not only our users' disposition and reasons
for looking at the documentation; but what information they're
looking for.
> Just another case of "Know Your Audience".
Absolutely. And *if you are reasonably perceptive*, training is an
ideal situation in which to introduce some humor. I still would not
recommend it to everyone. I've seen too many ugly things, like the
'professional motivational speaker' (ick!) who blithely made joke
after joke about the short, balding man who chuckled politely, or the
CEO who made a joke about two employees with limps in a three-legged
race. (Oh ho! It is funny how W. almost DIED after falling twenty
stories! HO HO HO!!!)
I'm not directing this at anyone, but I cringe at the idea of
advising people to use humor, as there are plenty of people who are
incapable of doing so.