Re: New TECHWR-L Poll Question

Subject: Re: New TECHWR-L Poll Question
From: CC <texchanchan -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 15 Oct 2001 15:45:59 -0700 (PDT)

I wrote this some years back.

==============================
Why being a technical writer makes me a better poet

1. Technical writers try to achieve both completeness
and accuracy. We have the advantage over poets in that
if we do not select the right words and put them
together in the right way, the customer calls our
company and says the product won't work. _We get
feedback._

This teaches about the relationship between the words
we think of and what the reader out there gets from
the words.

2. It is only the immature technical writer who hates
being edited. We learn to think of editing not as
being sent to the principal to be whipped for using
the wrong word, but rather as going to an
old-fashioned hardware store with knowledgeable and
friendly clerks who will help you pick out just the
right word.

We learn the value of editing and to take others'
opinions into consideration. This works against
literary solipsism. (So does #1.)

3. Writing and rewriting a manual, especially as the
product gets changed and updated by the engineers
during development, ingrains in the writer's mind the
idea that no set of words is graven in stone. You may
think you have described how to carry out a certain
procedure in the most perfect imaginable terms, but
then the engineers make a change in the hardware or
software and you have to throw out that section of the
book and start over.

>From this you learn that you can do it again; that
producing a good piece of writing was not a fluke, or
a one-time gift from the Muse. It's a skill, and you
can do good work over and over again just by applying
yourself.

4. Technical writing also teaches adaptability.
"Here, write a tech sheet telling them how to install
this."
"But what IS it?"
"It's an xd38 type f for the DSTM."
"Oh, yes, right, OK."

It's a widget of some kind or other. Not only do you
have to figure out what it is, many times you have to
figure out what kind of audience you're addressing by
deducing the function of the widget--not unlike an
archaeologist deducing a culture from its artifacts.

This sharpens perception and rewards unprejudiced
attention to detail.
==============================

C. Crowley

__________________________________________________
Do You Yahoo!?
Make a great connection at Yahoo! Personals.
http://personals.yahoo.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Announcing new options for IPCC 01, October 24-27 in Santa Fe,
New Mexico: attend the entire event or select a single day.
For details and online registration, visit http://ieeepcs.org/2001

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

---
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.


References:
New TECHWR-L Poll Question: From: Deborah Ray

Previous by Author: Re: Reading and Editing
Next by Author: Re: Jargon Lovin' Fool
Previous by Thread: RE: New TECHWR-L Poll Question
Next by Thread: Re: New TECHWR-L Poll Question


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

Sponsored Ads


Sponsored Ads