<html>
<head>
<style><!--
.hmmessage P
{
margin:0px;
padding:0px
}
body.hmmessage
{
font-size: 12pt;
font-family:Calibri
}
--></style></head>
<body class='hmmessage'><div dir='ltr'><div>Hi,</div><div><br></div><div>I'm wondering what's the best way to mark up paragraphs related to advising, warning, FYIs, contingencies, etc. I'm talking about such paragraphs that typically are prefixed by the word "Note:" or "n.b.," and are stylized differently from surrounding text.</div><div><br></div><div>For example:</div><div><br></div><div><ol></div><div> <li>Open the lid</li></div><div> <li>Place the sheet face down</li></div><div> <li>Press the copy button</li></div><div></ol></div><div><br></div><div>Note: If the paper jams, then you'll need to... (blah, blah)</div><div><br></div><div><br></div><div><br></div><div>I've noticed that these types of notes frequently occur in the HTML spec itself, styled in bold green typeface. For example:</div><div><br></div><div>For short inline annotations, the title attribute could be used.</div><div><br></div><div>Note: Unfortunately, relying on the title attribute is currently discouraged as many user agents do not expose the attribute in an accessible manner as required by this specification (e.g. requiring a pointing device such as a mouse to cause a tooltip to appear, which excludes keyboard-only users and touch-only users, such as anyone with a modern phone or tablet).</div><div><br></div><div><br></div><div><br></div><div>In the spec, such notes are marked up as <p class="note"> or <div class="note">. Is this considered the correct way, or is there a more specific element that could be used.</div><div><br></div><div>Some candidates I thought might be possible are <span style="font-size: 12pt;"><strong>, <em>, <i>, <b>, and <aside>:</span></div><div><span style="font-size: 12pt;"><br></span></div><div><span style="font-size: 12pt;"><strong> is described as having strong importance, seriousness, or urgency, and I don't think that fits these kinds of notes.</span></div><div><span style="font-size: 12pt;"><em> stress emphasis just doesn't seem to fit</span></div><div><span style="font-size: 12pt;"><i> this could work, in that it's described as "a span of text offset from the normal prose". But this element (also <strong> and <em>) are phrasing content, so can it be used to mark up an *entire* paragraph?</span></div><div><span style="font-size: 12pt;"><b> "attention is being drawn for utilitarian purposes". Again, it's phrasing content so it seems to be intended for use on a phrase rather than a paragraph. But it's semantics seems to "kind of" fit.</span></div><div><span style="font-size: 12pt;"><aside> I find it hard to say if advisory notes are tangentially related to surrounding content -- I would tend to think not. Also, <aside> is a sectioning element, and I don't think an advisory note is a different section.</span></div><div><span style="font-size: 12pt;"><br></span></div><div><span style="font-size: 12pt;">Any thoughts?</span></div><div><span style="font-size: 12pt;"><br></span></div><div><span style="font-size: 12pt;">Thanks,</span></div><div><span style="font-size: 12pt;">Gordon</span></div> </div></body>
</html>