RE: The Big Lie (was 'Are You a Writer?')

Subject: RE: The Big Lie (was 'Are You a Writer?')
From: jgarison -at- ide -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 5 Mar 2002 10:47:12 -0500

I've tried to keep my hands away from the keyboard in this debate, but I
just can't help myself any longer.

We are not merely "writers" we are, at our core, "communicators." Most often
we choose words as our medium for communicating. Communicators such as
ourselves are responsible for one thing:

* Getting knowledge out of one set of heads and into to another set of

Our ability to effectively communicate depends on several things:

* Obtain and understand input - this is where Andrew's challenge for us to
be technical enters in to the picture. We do need to be able to understand
the people who have the knowledge that we need to transfer. We need to be
able to get it and make sense of it before we can pass it along.

* Organize the input - we need to be able to put things together in a way
that will make sense to others. If we understand the information, but can't
organize it, we cannot communicate it well. We need to be able to develop
logical approaches, group like things together, and pick the best way to
present it to someone else. We do not present information in the same order
or fashion that we obtain it.

* Use our medium - once we understand and organize the information, we have
to be able to communicate it clearly, in our case, by using words. If we
cannot explain things well, or associate them via analogies to other things
people already understand, we'll have a very difficult time getting the
reader/user to understanding.

It takes ALL of these competencies to succeed as a writer. Mere technical
understanding is not enough. Mere writing ability is not enough. It takes

And that is what we are paid to do - learn, organize, instruct. Simple, huh?
Just you try to do it!

My 2¢,


-----Original Message-----

> In that course, ironically, I discovered an instructor who, whatever she
have *known* about
> those languages, was almost completely incapable of *communicating* her
knowledge in any linear,
> coherent way. Her inability in that regard was extreme, but some variation
that inability has been
> more typical than otherwise of many of the SME's I have encountered in
various fields over the years,
> which is why I find myself definitely less than impressed at refusals to
our basic ability to
> communicate as our distinctive value. In my experience, many can write
many fewer can write a
> coherent paragraph describing what the code amounts to or is used for.

Just because you didn't "get it" doesn't mean the instructor did not
communicate properly.

Communication, remember, involves two parties. There has to be somebody on
other end who is listening. The problem with most SMEs is they don't sugar
information. It tends to fly out in raw, unabridged manner indicative of
technical prowess. This doesn't mean they are incapable of communication,
just that their form of communication does not suit all audiences. Most
engineers communicate very well with each other. I don't know
but two people "speaking" sign apparently can get a lot across. Just because
don't get it doesn't mean their communication ability is bad.

Now's a great time to buy RoboHelp! You'll get SnagIt screen capture
software and a $200 onsite training voucher FREE when you buy RoboHelp
Office or RoboHelp Enterprise. Hurry, this offer expires February 28, 2002.

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: Tech writers and severance packages
Next by Author: RE: The Big Lie (was 'Are You a Writer?')
Previous by Thread: Re: The Big Lie (was 'Are You a Writer?')
Next by Thread: Re: The Big Lie (was 'Are You a Writer?')

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

Sponsored Ads