Re: Consequences of inadequate docs/training

Subject: Re: Consequences of inadequate docs/training
From: "Martin Page" <mpage -at- csl -dot- co -dot- uk>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 27 Mar 2002 14:14:35 -0000

"Tom Murrell"
> The documentation would have the biggest Danger Warning I could put in it.

I haven't seen any modern weapons manuals, but they must be full of
warnings - e.g. "Don't call down an air strike within 50m of your position."
"Establish positive identification before firing on target" and so on.

So, how do you avoid overloading the manuals with warnings and cautions to
the extent that you make the reader blasé or destroy their faith in the

(This probably also applies to other critical real-time systems, e.g.
medical software)

"Tom Murrell" <trmurrell -at- yahoo -dot- com> wrote in message news:147501 -at- techwr-l -dot- -dot- -dot-
> --- Martin Page <mpage -at- csl -dot- co -dot- uk> wrote:
> >
> > Surely the GIS machine should have been designed so that controllers
> > couldn't call down airstrikes on themselves.
> >
> > We're talking about a real time, high-stress and high-fatigue situation
> > a design that's the equivalent of having the rifle muzzle swing around
> > point at the user every time the magazine empties.
> >
> > If you were documenting the device in question, how would you highlight
> > potentially lethal feature so that you could sleep at night?
> First, I would fight like hell to have the device redesigned to be safer
> the user. Barring that, I would make damned sure they understood, in
> how it worked and what the consequences of such a reset would be.
> The documentation would have the biggest Danger Warning I could put in it.
> (Oh, and I don't particularly appreciate the flippant responses some have
> this question. In my opinion, it's a serious writing/training/design
> This is one of those situation where you not doing your job
> your politics at the door when you take the job--can get people killed.
> How would you sleep then? Huh?)
> =====
> Tom Murrell
> mailto:tmurrell -at- columbus -dot- rr -dot- com
> Personal Web Page -
> Page Last Updated 03/14/02
> "Technical Writers: Writers who get paid a living wage."
> __________________________________________________
> Do You Yahoo!?
> Yahoo! Movies - coverage of the 74th Academy Awards®

PC Magazine gives RoboHelp Office 2002 five stars - a perfect score!
"The ultimate developer's tool for designing help systems. A product
no professional help designer should be without." Check out RoboHelp at
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 for more resources and info.

Previous by Author: Re: Consequences of inadequate docs/training
Next by Author: Re: Ethical Companies (no flame wars, please)
Previous by Thread: Re: Consequences of inadequate docs/training
Next by Thread: Re: Consequences of inadequate docs/training

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

Sponsored Ads