RE: Re: Education (Was Re: Techwriting After the Boom)

Subject: RE: Re: Education (Was Re: Techwriting After the Boom)
From: "GeneK" <gene -at- genek -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: 09 Jun 2003 10:02:20 PDT


Speaking as someone who usually has one foot planted in
that category, I can tell you that "once upon a time" it
was considered part of the engineer's job to strip out
the parts of a product's technical description that the
intended reader didn't need while drafting user docs.
This resulted in a lot of arguements with Marketing,
which often seemed intent on inserting the entire patent
application description into those same user docs.
To this day, I often find myself confronting someone who
insists on inserting a long, complex "theory of operation"
into a user guide, and it's still almost always someone in
Marketing. Most of the products I work on these days are
under the control of people called "product managers" who
are actually in Marketing, but the engineers I work with
will hand me a mountain of data and say "okie" when I tell
them that their users aren't going to need 90% of it,
because deep down they'd really be happiest if their stuff
didn't have to have any user docs at all.

Gene Kim-Eng


------- Original Message -------
On
Mon, 9 Jun 2003 10:55:45 -0400 ?wrote:

It's a lot like technical writing by an engineer/SME. While the explanation of
the operation to it's tiniest subcomponent certainly strokes their ego, it's
useless to the reader who want to know how to accomplish something (ie: When the
bloody race is over who wins). The user of a VCR wants to know how to record and
playback a show. They couldn't care less about electron spin.


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Robohelp X3, from eHelp, lets you quickly and easily create
professional Help systems for all your Windows and Web-based
applications, including Net.

Buy RoboHelp Office X4 by June 13th and receive
$100 mail-in rebate, Plus FREE RoboHelp Plus Pack.

Order RoboHelp today: http://www.ehelp.com/techwr-l

---
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
http://www.raycomm.com/techwhirl/ for more resources and info.



Previous by Author: RE: Re: Education (Was Re: Techwriting After the Boom)
Next by Author: RE: RE: Education (Was Re: Techwriting After the Boom)
Previous by Thread: RE: Education (Was Re: Techwriting After the Boom)
Next by Thread: RE: Education (Was Re: Techwriting After the Boom)


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


Sponsored Ads