TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Have you spoiled a SME today? From:John Posada <JPosada -at- book -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Fri, 25 Oct 2002 18:27:16 -0400
I'm at the stage of my documentation where I'm cross-checking data between
sections to make sure everything is updated. I then check the values back to
the application.
One of the sections in my document has to do with error alert numbers and
based on a specific parameter, the developers are supposed to use a number
within a specific range.
This morning I sorted the table that I use to document these alert numbers
and discovered that about 20 of several hundred alerts are using the wrong
value range. So, I listed the ones that were wrong in an email and sent t to
the developer's list asking them to verify what I had.
The comment from one of the SMEs..."Well, YEAH, they're wrong. I was busy
that day, so I copied what I used for another range and expected John to
catch it and fix it."
Unfortunately, she now has to go back to her code, make the changes, and
retest...about a day's work.
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"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at http://www.ehelp.com/techwr-l
Buy ComponentOne Doc-To-Help 6.0, the most powerful SINGLE SOURCE HELP
AUTHORING TOOL for MS Word. SAVE $100 on the full version and $50 on the
upgrade. Offer ends 10/31/2002 (code: DTH102250). http://www.componentone.com/d2hlist1002
---
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.
