<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=us-ascii">
<meta name=Generator content="Microsoft Word 11 (filtered medium)">
<!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]-->
<style>
<!--
/* Font Definitions */
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
{font-family:"\@SimSun";
panose-1:2 1 6 0 3 1 1 1 1 1;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0mm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman";}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline;}
p
{mso-margin-top-alt:auto;
margin-right:0mm;
mso-margin-bottom-alt:auto;
margin-left:0mm;
font-size:12.0pt;
font-family:"Times New Roman";}
p.yiv1524717076hmmessage, li.yiv1524717076hmmessage, div.yiv1524717076hmmessage
{mso-margin-top-alt:auto;
margin-right:0mm;
mso-margin-bottom-alt:auto;
margin-left:0mm;
font-size:12.0pt;
font-family:"Times New Roman";}
p.yiv1524717076hmmessage1, li.yiv1524717076hmmessage1, div.yiv1524717076hmmessage1
{mso-margin-top-alt:auto;
margin-right:0mm;
mso-margin-bottom-alt:auto;
margin-left:0mm;
font-size:10.0pt;
font-family:Tahoma;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:Arial;
color:navy;}
@page Section1
{size:612.0pt 792.0pt;
margin:72.0pt 90.0pt 72.0pt 90.0pt;}
div.Section1
{page:Section1;}
-->
</style>
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple>
<div class=Section1>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'>In the medical device industry (which is where
I currently work), we use Warnings, Cautions and Notes in precisely the manner –
and order – described below. <o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'>Only Warnings gets an icon (exclamation
point inside a triangle).<o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'><o:p> </o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'>Alison<o:p></o:p></span></font></p>
<p class=MsoNormal><font size=2 color=navy face=Arial><span style='font-size:
10.0pt;font-family:Arial;color:navy'><o:p> </o:p></span></font></p>
<div>
<div class=MsoNormal align=center style='text-align:center'><font size=3
face="Times New Roman"><span style='font-size:12.0pt'>
<hr size=2 width="100%" align=center tabindex=-1>
</span></font></div>
<p class=MsoNormal><b><font size=2 face=Tahoma><span style='font-size:10.0pt;
font-family:Tahoma;font-weight:bold'>From:</span></font></b><font size=2
face=Tahoma><span style='font-size:10.0pt;font-family:Tahoma'>
framers-bounces@lists.frameusers.com
[mailto:framers-bounces@lists.frameusers.com] <b><span style='font-weight:bold'>On
Behalf Of </span></b>David Spreadbury<br>
<b><span style='font-weight:bold'>Sent:</span></b> August 1, 2011 5:18 AM<br>
<b><span style='font-weight:bold'>To:</span></b> hessiansx4@yahoo.com;
framers@lists.frameusers.com; mathieu jacquet<br>
<b><span style='font-weight:bold'>Subject:</span></b> RE: warnings, cautions,
notes in sw documentation</span></font><o:p></o:p></p>
</div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'><o:p> </o:p></span></font></p>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0>
<tr>
<td valign=top style='padding:0mm 0mm 0mm 0mm'>
<div id=yiv1524717076>
<div>
<p class=MsoNormal style='margin-bottom:6.0pt'><font size=3
face="Times New Roman"><span style='font-size:12.0pt'>The use of Warnings,
Cautions, and Notes, specifically Warnings and Cautions, are used differently
in different technologies.<br>
<br>
Here are some links that may hep you to decide which use best fits your
needs:<br>
<br>
http://www.techcommunicators.com/dkmanual/chap5015.html<br>
http://www.techcommunicators.com/emanuals/wrm/chap06/06-13_notes.htm<br>
http://www.stc-soc.org/quill/2004-05/warnings.html<br>
http://www.tpub.com/content/tentsshelters/TB-9-2320-360-13-P-2/TB-9-2320-360-13-P-20234.htm<br>
http://www.techwr-l.com/archives/0403/techwhirl-0403-00541.html<br>
http://goodtools.net/pages/SUNstyle/constr8.htm<br>
http://support.dell.com/support/edocs/systems/op990/en/SM/SFF/GUID-EA258A9C-D5EA-43BE-9A44-E8B52A0E594F.html<br>
<br>
And MIL-STD-38784C states:<br>
WARNINGS : Highlights an essential operating or maintenance procedure,
practice, condition, statement, etc, which, if not strictly observed, could
result in injury to, or death of, personnel or long term health hazards.<br>
<br>
CAUTIONS: Highlights an essential operating or maintenance procedure,
practice, condition, statement, etc, which, if not strictly observed, could
result in damage to, or destruction of, equipment or loss of mission
effectiveness.<br>
<br>
NOTE: Highlights an essential operating or maintenance procedure, condition,
or statement.<br>
<br>
Another thing that most people don't adhere to is that WARNINGS should come
before CAUTIONS, which should come before NOTES, when any two, or all three,
may apply to the following paragraph or section.<br>
<br>
<font color=navy><span style='color:navy'>-------------------------------------------------------------------------------------------</span></font><o:p></o:p></span></font></p>
<div>
<p class=MsoNormal><font size=3 face="Times New Roman"><span
style='font-size:12.0pt'>> Date: Sun, 31 Jul 2011 20:42:37 -0700<br>
> From: hessiansx4@yahoo.com<br>
> Subject: warnings, cautions, notes in sw documentation<br>
> To: framers@lists.frameusers.com<br>
> <br>
> Hello all! I've noticed that the legacy docs I'm currently working on
use notes and warnings (no cautions) for a software product. I asked why a
warning was used instead of a caution and was told: that's the way we do it
here. I've only used warnings when bodily harm could result from some action.
How are those of y'all in the sw world doing it? <o:p></o:p></span></font></p>
</div>
</div>
</div>
</td>
</tr>
</table>
<p class=MsoNormal><font size=3 face="Times New Roman"><span style='font-size:
12.0pt'><o:p> </o:p></span></font></p>
</div>
</body>
</html>