Re: Consequences of inadequate docs/training

Subject: Re: Consequences of inadequate docs/training
From: Tom Murrell <trmurrell -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 27 Mar 2002 04:31:29 -0800 (PST)


--- Andrew Plato <intrepid_es -at- yahoo -dot- com> wrote:
>
> And one of a million reasons why it is critically important to understand the
> products & technologies you're documenting. No amount of internationally
> recognized process methodologies, FrameMaker tricks, or information mapping
> theories will assuage people who got hurt because the writers (or trainers)
> refused to learn the products they were documenting.

Actually, to take the point a bit further, the original example of a device
that defaults to the sender's location, it helps in the design, documentation,
and training to know the environment in which the device is to be used.

The original situation is on where you really need the device to default to
something safe for the user. So the best fix is to design the GPS Locator
differently. Barring that, both documentation and training must understand not
only how the device work but how it is to be used. Believe me, in combat you
only use a manual when you run out of ammunition and only if it has some heft
to it.

(I'll bet some of you thought I never read Andrew's posts. <g>)

=====
Tom Murrell
mailto:tmurrell -at- columbus -dot- rr -dot- com
Personal Web Page - http://home.columbus.rr.com/murrell/index.html
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®
http://movies.yahoo.com/

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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
http://www.ehelp.com/techwr
---
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.



Follow-Ups:

References:
Re: Consequences of inadequate docs/training: From: Andrew Plato

Previous by Author: Re: More on Validating documentation
Next by Author: Re: Consequences of inadequate docs/training
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


Sponsored Ads