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.
Cent one: SMEs reviewing the doc for technical
accuracy may reduce tech support costs (usually a
MAJOR expense) because readers will have the correct
information. (BTW, don't discount users and trainers
as SMEs.)
Cent two: The SME's charge should be something like:
Dear [SME's name/title - for tracking]
Please review the attached material for technical
accuracy and completeness. If technical deficiencies
are found, please either provide information or a
source that will provide information to correct the
deficiency.
Return the reviewed material on/before [reasonable
date]. If you are unable to complete the review and
return the material on/before [same date] please
contact [person/phone number/email]. If the material
is *not* [emphasize] returned by [same date] it will
be considered to have been reviewed and approved by
you.
Your careful review of the material is critical to the
success of the company and is most appreciated.
[signed documentation manager]
Cent 3 (a bonus for reading this far): _ALL_ tech pubs
must be reviewed on a scheduled basis as long as the
product is in revision (that is, until the product is
discontinued). Pubs may NOT be aware of a vendor
change that can impact parts lists, etc. - Engineering
considered the change 'of no importance.' That should
(must) by a Pub's decision (to include/not to
include). Pubs cannot depend solely on SMEs (alas).
===
Katav ( katav -at- yahoo -dot- com )
''Despise not any person and do not deem anything unworthy
of consideration, for there is no person without his hour,
and no thing without its place'' {Ben Azzai [Avot 4:2]}
_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com