Re: Real Tech Writers

Subject: Re: Real Tech Writers
From: Erich Schildhauer <Erich -dot- Schildhauer -at- POET -dot- DE>
Date: Mon, 29 Sep 1997 10:02:21 +0200

Debbie,

> <snip> We have problems. It seems that the
> managers in IS don't understand what technical writers do but they seem
> to think they need them. They think technical writing is word processing
> and consequently end up hiring people who know a lot about software
> packages and cool PC tools and toys but don't know how to do research and
> writing. I seem to be the only one who is serious about producing good
> documentation. Does anyone out there have suggestions for educating these
> people? We don't have a chance of establishing a professional department
> if the IS managers don't know how to hire professional writers.

Matt suggested teaching by example, comparing the final results of the
work by different "types" of authors. While I agree that in the end the
results are what really counts, I'm not sure the comparison between
"good and bad technical documentation" will really make your point clear
to your managers.

I have another idea:

1) Outline the complete PROCESS of writing good technical documentation,
as you see it.

2) Define the specific skills needed to carry out all the steps in this
process.

3) Compare the skills offered by the "real technical writers" and the
"software jockeys" (as you put it).

Somewhere along the way, management should understand that just being an
expert user of certain word processing applications is not enough to do
the job properly.

Just a suggestion.

Erich

--
Erich Schildhauer Phone: +49 40 60990-0
POET Software GmbH Fax: +49 40 60990-115
Fossredder 12 Mail: Erich -dot- Schildhauer -at- poet -dot- de
D-22359 Hamburg Info: http://www.poet.com/

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: Native English Speaking Requirement
Next by Author: Re: Anyone use Ventura?
Previous by Thread: ref: Web style guides
Next by Thread: Re: What's This?" help


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


Sponsored Ads