RE: Bouncing Reality Checks

Subject: RE: Bouncing Reality Checks
From: "Mike O." <obie1121 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 9 Dec 2002 11:42:04 -0800 (PST)



--- KMcLauchlan -at- chrysalis-its -dot- com wrote:
> > I'd tell him I tested it and it's already 100% accurate.
>
> Careful. Somebody might record a little statement
> like that and fling it back in your face

True... nobody wants to be on record saying something is 100%
accurate. Maybe that's why the SME doesn't want to review it.

But you can usually test software to a pretty high degree of
confidence before writing the topic. I am allergic to writing
"The GetFoo call returns 'foo'" unless I have a timestamped
piece of actual sample code that I ran myself. If someone says
your doc is incorrect, it helps to be able to rerun the test or
refer to the code to demonstrate your doc is actually correct.

I find SME reviewers tend to just scan for errors. That's OK,
but what I really need an SME for is to tell me what I forgot to
write.

Now that I think about it, I realize all my SME contact usually
occurs early on in the process and is built into the docs. So
when the doc is done, SME review is pretty much superfluous.

Also, think about the hidden assumptions from the SME in the
original post: Why does the SME assume that if he doesn't review
it it won't be accurate? Why does he assume that it will be 100%
accurate *after* he reviews it?



__________________________________________________
Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
http://mailplus.yahoo.com


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

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!

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


References:
RE: Bouncing Reality Checks: From: KMcLauchlan

Previous by Author: Re: Bouncing Reality Checks
Next by Author: Re: Speak German or Italian? Got 5 seconds? HELP!
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