RE: He said...She said...He said...etc.

Subject: RE: He said...She said...He said...etc.
From: "CB Casper" <knowone -at- surfy -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 27 Feb 2002 22:09:27 +0400

All of the skills you mentioned differentiate a
Tech Writer from other writers. I equate the reader
with the person who reads the documentation to use
the product. We agree that a TechWriter is an
advocate for the end user of the product, part of
this consists of the documentation.
I'm not an advocate for the reader, I'm an advocate for the product user.
If that means writing a document, so be it. It also means designing a
document that can be read and absorbed, often with graphics and attention to
typographical issues. But it also means designing effective product
interfaces, figuring out whether extensive training will be required, how to
make a knowledge base accessible to the users, and a thousand other items
that may or may not be directly related to technical writing, but absolutely
essential to a successful user experience.

Connie P. Giordano

-----Original Message-----
Another point not included on this enjoyable
discussion is that the TW is the advocate for
the reader. Not only do we have to have enough
technical expertise to write and edit the material
at hand, we also need the ability to step back
from our docs and view them from the user
perspective. This is a skill that is sorely
lacking in the vast majority of people, let alone
the technical experts, thus another reason for tech

Not only do we have to write with technical
expertise, we have to be able to read without
it, and recognize the difference. I believe
this is a skill that differentiates technical
writers from other writers.


Surfy! Great web search, free web email, and $9.95 unlimited Internet access

Powered by Outblaze

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: Speaking of specific job requirements...
Next by Author: RE: How to word warning on electromagnetic frequency (EMF)?
Previous by Thread: RE: He said...She said...He said...etc.
Next by Thread: RE: He said...She said...He said...etc. (Was Re: What's A TW Got To DO To Get A Job Around Here?!)

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

Sponsored Ads