RE: Bouncing Reality Checks

Subject: RE: Bouncing Reality Checks
From: John Posada <JPosada -at- book -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 9 Dec 2002 13:25:41 -0500


I believe in accuracy as much as the next anal technical writer, but I try
to temper it with a little pragmatism.

> > THE Subject Matter Expert on this particular capability
> > asked, "Do we want this documentation to be 100% accurate?
> > Or is pretty close good enough for our needs?" It seems
> > that he was concerned with whether or not he actually needed
> > to review the documentation...

> I'd tell him I tested it and it's already 100% accurate.

>> Ask him if his code is 100% bug free.

A bug in the application crashes 4 times a second or a dialog message says
"Select the data file or foldar, then click the Next button" Both are errors
and make the application less than 100% accurate" Is it possible that an
error can be less than a big deal?


>>Out of every 12-pack of sodas, at least one can contains a roach.
>>and so on.

Out of every 12 pack, at least one label is applied .05mm below the
specified line. it is still an error.


>As we used to say (referring to operating system bugs), a one-in-a-
million bug happens four times a second....

Only if that part of the operating system is run 4 million times a second.

John Posada
Senior Technical Writer
Barnes&Noble.com
jposada -at- book -dot- com
212-414-6656
"Be accurate...the 4am wakeup call you prevent could be your manager's"



-----Original Message-----
From: LDurway -at- pav -dot- com [mailto:LDurway -at- pav -dot- com]
Sent: Monday, December 09, 2002 1:08 PM
To: TECHWR-L
Subject: RE: Bouncing Reality Checks




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

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



Follow-Ups:

Previous by Author: RE: Bouncing Reality Checks
Next by Author: RE: Description of Tech Writers
Previous by Thread: Re: Bouncing Reality Checks
Next by Thread: RE: Bouncing Reality Checks


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

Sponsored Ads


Sponsored Ads