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:Re: Caution and Warning usage in documentation From:Fred Wersan <wersan -at- ZEUS -dot- MA30 -dot- BULL -dot- COM> Date:Fri, 7 Jan 1994 14:28:35 EST
----- Begin Included Message -----
From: Paul Brady 5797 <PBrady -at- CHIPCOM -dot- COM>
Subject: Caution and Warning usage in documentation
I have a question about the industry standard regarding the use of Cautions
The following are the current definitions we use in our documentation for
cautions and warnings:
WARNING: Indicates that a condition may threaten personal safety.
CAUTION: Indicates that a condition may damage software or hardware.
Recently, however, I was told that this may not be ISO 9000 or UL compliant.
Is this true? Any comments are much appreciated!!
----- End Included Message -----
We pretty much use the same definitions and we are an ISO 9000 certified site,
so either it's OK, or they didn't ask us about this detail. My understanding
of ISO is that they are not that specific. They require that you have standards
and procedures that are documented and reproducible, but they don`t (for the
most part) tell you what the specifics have to be.
However, this is one area where some industry standardization makes sense. You
would want any person picking up any documentation to know that when they see
Warning or Caution that it means the same thing. This allows them to respond
appropriately. In a situation that could threaten personal safety, you don't
want someone to have to stop and think whether they should be worried about
the equipment, themselves, or just the fears of an overly melodramatic writer.
They should just be able to respond.
Bull HN Informations Systems
300 Concord Rd.
Billerica, Mass. 01821
f -dot- wersan -at- bull -dot- com