RE: This too is technical communication

Subject: RE: This too is technical communication
From: Chris Borokowski <athloi -at- yahoo -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Tue, 5 Jun 2007 06:54:41 -0700 (PDT)

When I write instructions to anyone, no matter how
intelligent, I design for a clueless ingenue stumbling
onto the scene. Why? Documentation is read in a hurry,
scanned for data, and often is used in the midst of
utter chaos. It's not insulting their intelligence to
make it crystal clear, so long as you give
information. It is insulting their intelligence to
dumb it down, and hide away useful information because
it doesn't fit into a simplistic interface. (This was
why using MacOS 9 and Windows 3.1 was so painful.)

--- "Pinkham, Jim" <Jim -dot- Pinkham -at- voith -dot- com> wrote:

> If part of being a "professional clueless idiot"
> implies my editor's
> point of view -- assume that if there's any
> possibility readers can
> misconstrue a piece of writing, some definitely will
> -- then Mike is
> right on track. We certainly should be masters of
> clarity and lack of
> ambiguity. At the same time, as Stuart correctly
> indicates, we should
> not assume inferior intelligence or inability on the
> part of our readers
> to understand a concept clearly and comprehensively
> conveyed.

User Interface design blog

Get the Yahoo! toolbar and be alerted to new email wherever you're surfing.

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

RE: This too is technical communication: From: Pinkham, Jim

Previous by Author: Re: This too is technical communication
Next by Author: Re: This too is technical communication
Previous by Thread: RE: This too is technical communication
Next by Thread: Fwd: This too is technical communication

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

Sponsored Ads