RE: Theory vs. Practice (was: What's a TW etc...)

Subject: RE: Theory vs. Practice (was: What's a TW etc...)
From: Donald -dot- H -dot- White -at- pmusa -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 27 Feb 2002 13:50:31 -0500

What was the question? Is it that, in order to write about Unix applications
the tech writer must first be a master Unix programmer/engineer? If a
purported tech writer obtains information from and coordinates drafts with
subject matter experts, then that person is no real technical writer?

I see adverts all of the time for technical writers; advertisements that
make it clear the employer wishes to obtain someone completely proficient in
the programming and engineering of a particular language or tool set. Well,
I'm not such an expert. I believe that the ability to perform research and
analysis on a scale similar to that we attach to systems analysts is
essential to this field, but we are writers first and foremost. We have to
be able to learn the intricacies of our subject, through materials and
individuals, and communicate that in a form readily accessible by our
potential (or planned) audience.

Of course, every project or assignment involves a "learning curve."
Otherwise, we'd just provide pro-forma documents based upon our portfolios
(?), wherein we simply change the terms or nouns to "fit" the current task.

Don White
Technical Writer
dwhite -at- venturipartners -dot- com

-----Original Message-----
From: Bruce Byfield [SMTP:bbyfield -at- axionet -dot- com]
Sent: Wednesday, February 27, 2002 1:44 PM
To: TECHWR-L
Cc: TECHWR-L
Subject: Re: Theory vs. Practice (was: What's a TW etc...)

MichaelHuggins -at- aol -dot- com wrote:

>No doubt there are people like that in the writing field as well as
in every other field, but I'm not sure what the comments above have to do
with the recent thread. No one has claimed that anyone should attempt to
write "without a reasonable understanding" of their subject, nor did anyone
advocate "coasting." As I pointed out before, half the posts here seem to
consist of so-called rebuttals to claims that were never made to begin with.
>
I suppose that depends on how you define "reasonable understanding."
>From the context of my last post, I would have thought that my definition
was reasonably clear.

However, in case it wasn't, I meant: enough knowledge that you're
not not dependent on SMEs to tell you if what you've written is complete or
technically accurate.

Conversely, if you are heavily dependent on SMEs for this
information and make no effort to correct that dependency, that's coasting.


--
Bruce Byfield 604.421.7177 bbyfield -at- axionet -dot- com

"It's as bad as it gets
The Surgeon General said, 'you're better off with cigarettes,'
If you must have your bad habits, why don't you stick to booze:
Love's been linked to the blues."
-David Olney, "Love's Been Linked to the Blues"



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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. www.ehelp.com/techwr

Have you looked at the new content on TECHWR-L lately?
See http://www.raycomm.com/techwhirl/ and check it out.

---
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: WWP List
Next by Author: RE: RE: What then is the SME/TW functional relationship?
Previous by Thread: Re: What then is the SME/TW functional relationship? (was Re: Theory vs. Practice (was: What's a TW etc...)
Next by Thread: Word 2000 TOC question


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


Sponsored Ads