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

Subject: RE: Important Stuff They Don't Teach In Tech Writing School
From: "Goldstein, Dan" <DGoldstein -at- DeusTech -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 27 Aug 2004 12:40:52 -0400


> -----Original Message-----
> From: Andrew Plato
> Sent: Friday, August 27, 2004 12:17 PM
> To: TECHWR-L
> Subject: Re: Important Stuff They Don't Teach In Tech Writing School
>
> > ...You are the advocate for the end user. Everything you do is
> > ultimately
> > for the end user. Sometimes your client needs a gentle reminder --
> > "That's an interesting suggestion, but how does it help the
> > end user?"...
>
> No. Good writing is not about activism for users. This is an
> idiotic concept
> that has been infecting writers for too long. Where did you
> ever get the idea
> that the users need advocates?...

Don't be an "advocate." Be a good tech writer. Good end-user documentation
must be useful to the end user.

Everything you do is *not* ultimately for the end user -- it's for the
client. But giving users what they need can improve the client's bottom
line: If your documentation actually gets read (some of us are that lucky),
focusing on the user's needs can increase sales and reduce service calls.

Dan Goldstein

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

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.



Previous by Author: RE: Subject: "Powered by RoboHelp" go bye-bye!!
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