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.
Re: CNET Editor Death Caused by a Technical Communication Mistake?
Subject:Re: CNET Editor Death Caused by a Technical Communication Mistake? From:"Gene Kim-Eng" <techwr -at- genek -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Thu, 7 Dec 2006 09:46:49 -0800
I've never seen a roadmap that didn't say "check local road
conditions." The family had a planned route, missed a turn
and instead of retracing their path and getting back on the
planned route chose a new one on the fly without stopping
to verify it was a good choice.
At the risk of adding another insensitive comment, this
tragedy was the result of a foolish error. But it's only the
beginning of the winter travel season, and anyone with a
trip still in the planning stage would do well to remember
that even very smart people can make very foolish errors.
Documentation should never be expected to act as a
replacement for exercising common sense.
But is this something that will be obvious to the end-user map-reader?
We, as technical communicators, already know that if we don't make all
the information really easy to find, preferably all in the same place,
then whatever requires an effort won't be read.
While there is plausible deniability in telling people to do things we
know they won't do, it's not awfully helpful.
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Easily create HTML or Microsoft Word content and convert to any popular Help file format or printed documentation. Learn more at http://www.DocToHelp.com/TechwrlList