Re: Important Stuff They Don't Teach In Tech Writing School

Subject: Re: Important Stuff They Don't Teach In Tech Writing School
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 27 Aug 2004 10:48:29 -0700


"Andrew Plato" <gilliankitty -at- yahoo -dot- com> wrote...
>
> No. Good writing is not about activism for users.

Good catch, I missed that one...

As a technical writer you are a part of the product development team.
As such, your responsibility is to support the successful completion,
release and support of the product by ensuring that the necessary
information is provided for the end user to successfully use the product
for its advertised purpose with a minimal impact on your company's
product support resources. What this amounts to is providing the
user with just enough information, not giving away the store by
handing over company proprietary data because you think the user
will find it useful or interesting and getting the documents done in time
to deliver with the completed product. In order to do this, you need
to know what the user knows, what the user does *not* know,
what the user needs to know and what the user does *not* need to
know. Knowing what the user may *want* or *like* to know may
be of some value, but it better not be what's driving your efforts to
document a product that is supposed to ship on time and make a
profit for the company.

Gene Kim-Eng


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

ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl

WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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.



Follow-Ups:

References:
Re: Important Stuff They Don't Teach In Tech Writing School Was Re: School vs experience...: From: Sue Ellen Colter
Re: Important Stuff They Don't Teach In Tech Writing School Was Re: School vs experience...: From: Tony Markos
Re: Important Stuff They Don't Teach In Tech Writing School Was Re: School vs experience...: From: Nora Merhar

Previous by Author: Re: Important Stuff They Don't Teach In Tech Writing School
Next by Author: Re: Important Stuff They Don't Teach In Tech Writing School
Previous by Thread: Re: Important Stuff They Don't Teach In Tech Writing School
Next by Thread: Re: Important Stuff They Don't Teach In Tech Writing School


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


Sponsored Ads