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: YOU are responsible, even when YOU are not to blame
Subject:Re: YOU are responsible, even when YOU are not to blame From:SteveFJong -at- aol -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 10 Apr 2003 23:01:25 EDT
John Posada <JPosada -at- book -dot- com> wrote:
"[N]ot to belabor the point, but what does any of this matter? To know error
is to fix error. No blame, just fix."
Finally, a chance to salvage something from this thread! Don't you get bored
of forever fixing error? Wouldn't it be better to *prevent* error? It's much
easier to do things right the first time--faster, more efficient, less
stressful, and (a bonus!) more error-free. But how do you do that?
If all you want is to fix errors, you don't care where they come from; you
assign blame--er, responsibility, the writer fixes them, and you repeat the
cycle endlessly. It's slow, inefficient (think of the scrap and rework),
stressful, and error-prone. It never gets better.
If, however, you want to *prevent* errors, you first have to determine where
they come from--their root cause. Root cause analysis considers four possible
sources of error: people, processes, tool, and materials. Errors can come
from all four sources--not just in manufacturing, where the method origi
nated, but in software and documentation too.
To take a simple and universal example, where do typos come from? Brainstorm
root causes and you'll come up with much more than "the writer can't spell."
Here's my list. Can you add more? None of it is made up; I have personally
witnessed (or committed!) everything here:
PEOPLE
Writer can't spell
Writer can't see monitor clearly
PROCESSES
No time to check spelling
Spellchecking not routinely performed
Spellchecking not done as last step
Spellchecker includes user-added typos
Engineer allowed to add edits directly
Artist misspelled captions
TOOLS
No spellchecker software
Monitor too small to see text clearly
System so slow writer dozed during spellchecking
Writer accepted all spelling suggestions
Keyboard malfunctioning
MATERIALS
Typo in spec; writer copied spec
Typo in previous revision; writer didn't spot
Don't underestimate the problem of an inadequate monitor (or poor ambient
lighting). Right now I work with an editor whose struggle to read the screen
is painful to watch: she takes off her glasses and puts her face RIGHT UP to
the screen. It doesn't help that we all have 15-inch monitors. (I got rid of
the 15-inchers at my last job five years ago.) One could admonish us to spell
better, but that's not the root cause.
This is a trivial example. There are more important real-world examples. I
would suggest "inaccurate procedures" would be an important problem, worthy
of detailed analysis.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Purchase RoboHelp X3 in April and receive a $100 mail-in
rebate, plus FREE RoboScreenCapture and WebHelp Merge Module.
Order here: http://www.ehelp.com/products/robohelp/
Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday TECHWR-L....
---
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.