Best practices for factory worker/plant personnel documentation?

Subject: Best practices for factory worker/plant personnel documentation?
From: "Hart, Geoff" <Geoff-H -at- MTL -dot- FERIC -dot- CA>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 12 Dec 2002 13:00:12 -0500

Dianne Moscrip wonders: <<What's the best format to use when documenting
operating procedures inside a plant?>>

Depends entirely upon the type of plant; the kind of documentations you'd
use in a clean-room environment such as that used in manufacturing chips
would differ enormously from that in a metal foundry, which would in turn
differ from that in an assembly line for stereos. Before you can answer your
question, you need to do a bit of contextual inquiry to find out about the
work environment and how workers function within that environment.

<<Would workers read a manual?>>

If they have the kind of job where they have leisure to read through a
manual. Otherwise, manuals typically get consulted _after_ (in)formal
training to resolve specific problems. You also have to ask whether a paper
manual would survive the work environment (which may be wet, greasy, etc.)
and whether an online manual could be used at all (e.g., in an environment
hostile to computers).

<<Would you recommend setting up a kiosk where workers could access the most
recent operating procedures via an Intranet?>>

Not if they need the information close at hand during their regular

<<Should the operating procedures be printed out and mounted on the wall?>>

I've seen some very effective documentation mounted directly on machines
(e.g., photocopiers) or "embedded" in the process itself (e.g,. onscreen
programming of VCRs); similarly, warning messages are most likely to be read
if they occur right on the machine rather than hidden away in a manual
somewhere. "On the wall" documentation may be read and referred to, but you
can't guarantee that will happen if the wall isn't right next to the machine
unless the plant has a formal process for reminding workers to read this

All of this is the long way of saying that each situation has unique
elements, and without a clear understanding of how the audience will use
your information in that context, you won't be able to produce truly usable

--Geoff Hart, geoff-h -at- mtl -dot- feric -dot- ca
Forest Engineering Research Institute of Canada
580 boul. St-Jean
Pointe-Claire, Que., H9R 3J9 Canada

"Writing, in a way, is listening to the others' language and reading with
the others' eyes."--Trinh T. Minh-Ha, "Woman native other"

Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from
Find out what all the other tech writers, including Dan, already know!

Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today 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: Anyone know anything about The Help Factory?
Next by Author: How to make symbols stand out?
Previous by Thread: RE: best practices for factory worker/plant personnel documentati on
Next by Thread: STOP: RE: Anyone know anything about The Help Factory?

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

Sponsored Ads