RE: Solution! RE: pushpins

Subject: RE: Solution! RE: pushpins
From: John Posada <JPosada -at- book -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 2 Jul 2003 09:10:56 -0400

>being right. [Maybe] not in your case, Sean, but I've
>seen writers - especially inexperienced ones -
>crippling themselves worrying over being
>right to the point that they had no energy left
>over for anything else.

Disclaimer...I write for internal readers, not for inclusion in packaged
software, and I don't write instructions on how to operate a space shuttle
or nuclear reactor.

I go on the assumption that since I'm documenting a moving target (if it
wasn't "moving", there wouldn't be 15 or more developers making changes
faster than I can keep up), and much of what I write is based on subjective
rather than objective information, I guarantee that my documentation
contains errors...the best I can hope for is 95% correct, ad that's

I explain this to my users and they never have a problem with this.

I also tell them that I EXPECT feedback on errors and omissions. For those
who receive my documentation aside from normal distribution channels, it's
my charge for giving it to them.

John Posada
Senior Technical Writer
jposada -at- book -dot- com


Create professional Help systems that feature interactive tutorials and
demos with all new RoboHelp Studio. More at

Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-

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: For you Linux fans
Next by Author: RE: pinpointing a web page
Previous by Thread: Saying what we mean
Next by Thread: Re: pushpins

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

Sponsored Ads