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.
Subject:Caution, warning, and danger From:David Oberstadt <daveo -at- VNET -dot- IBM -dot- COM> Date:Fri, 3 Jun 1994 10:06:02 PDT
----------------------------------------------------------------------
From: "Vollbach, Elizabeth" <evollbach -at- CCLINK -dot- LOGICON -dot- COM>
"what do we use instead (of using "should, "must," etc.) to convey an
imperative that should not be taken lightly?" Easy.
Do like they do in mil-specs and standards. Add a "Caution" or
"Warning."
----------------------------------------------------------------------
Our marketing people will not allow such a thing. I think OSHA
(Occupational Safety & Health Admin. or something) has official
standards for these--something like:
Caution - follow instructions or your equipment may be damaged
Warning - follow instructions or may be injured
Danger - follow instructions or you may be seriously injured or die
When working with software, the worst that could happen is you
destroy all of your data. Yes, this could cost millions of dollars,
but according to OSHA standards, does not constitute a caution,
warning, or danger message.
What do you do in such instances? Important instructions sometimes
require more than a little box that says 'Note:'. I rather favor
the international exclamation point and sometimes the circle with
line through it (the DO NOT symbol). They are quickly identified
and don't carry definitions given by OSHA or others (as far as I
can tell). Is there a CUA standard for this I don't know about?
David Oberstadt Santa Teresa Lab
daveo -at- vnet -dot- ibm -dot- com San Jose, California