Re: Jargon Lovin' Fool

Subject: Re: Jargon Lovin' Fool
From: Andrew Plato <intrepid_es -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 19 Oct 2001 16:31:15 -0700 (PDT)

"Bonnie Granat" wrote...

> Nongeek users want to know how to perform a task using the software.
> don't want some self-absorbed airhead "educating' them. Give them what
> want -- that's what "know thy audience" means -- and don't give them
> you think they should want.

Nongeeks and geeks all want the same thing - information. The more
pleasantly you ram information into their heads, the happier they are.

If your documentation is merely instructions...then you're not giving them
complete information. You're just bossing them around. Giving them just
enough information to do the task, but not to understand why the task is
done. There is no insight in instructing people. Anybody can do that.

To communicate REAL knowledge to people you have to educate them. Show
them why things are done. What the reasoning is behind technologies,
designs, and tasks. Feed them a steady diet of "why are you doing this and
why is it useful."

As for being educated by self-absorbed air-heads...

Educating readers means taking an active role in the process of
communicating concepts, ideas, *and* instructions.

Instructing means you can follow a bouncing ball and spit back the steps
on paper.

Now, which is more airheaded?

Andrew Plato

Do You Yahoo!?
Make a great connection at Yahoo! Personals.

Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: Jargon Lovin' Fool
Next by Author: Re: Jargon Lovin' Fool
Previous by Thread: RE: Jargon Lovin' Fool
Next by Thread: Re: Jargon Lovin' Fool

What this post helpful? Share it with friends and colleagues:

Sponsored Ads