changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
--- a/longdesc1/longdesc.html Sat Dec 14 11:49:23 2013 -0500
+++ b/longdesc1/longdesc.html Sat Dec 14 12:45:39 2013 -0500
@@ -13,7 +13,7 @@
border: 1px solid black;
color: #404;
padding: 2px;
- content: "Example: (non-normative)"}
+ content: "Example: (Informative)"}
.example:first-child {padding-top:1em}
@@ -51,7 +51,7 @@
color: green;
margin-top: -20px;
padding: 2px;
- content: "This box is non-normative.";
+ content: "This box is informative.";
}
/* Fancy table stuff */
table {
@@ -458,8 +458,11 @@
</section>
<section id="conformance">
<h2><span class="secno">1. </span>Conformance</h2>
- <p>All authoring guidelines, diagrams, examples, notes, and sections marked non-normative
- in this specification are non-normative. Everything else in this specification is normative. </p>
+ <p>All authoring guidelines, diagrams, examples, notes, and sections marked
+ "<a href="http://www.w3.org/TR/qaframe-spec/#informative-def">informative</a>"
+ in this specification are informational. Everything else in this specification is
+ "<a href="http://www.w3.org/TR/qaframe-spec/#normative-def">normative</a>" as described in
+ [<a href="#bib-QAFRAME">QAFRAME</a>]. </p>
<p>The key words <em title="must" class="rfc2119">"must"</em>, <em title="should"
class="rfc2119">"should"</em>,
<em title="should not" class="rfc2119"></em><em title="recommended" class="rfc2119"></em>and
@@ -497,7 +500,7 @@
<dd>Identifying an image is often important context for a discussion.
There are many well-known images which are widely reproduced and well
known. In some cases, such as "Mona Lisa", "Guernica", "A Starry Night",
- "The Scream", the most effective way to identify an
+ or "The Scream", the most effective way to identify an
image is to use its title, creator, and similar information that would
be found in a catalog. But different people know images by different
titles, and some titles are not well known. When the image itself
@@ -795,6 +798,10 @@
<section id="informative-references">
<h3><span class="secno">B.2 </span>Informative References</h3>
<dl class="bibliography">
+ <dt id="bib-QAFRAME">[QAFRAME]</dt>
+ <dd>Karl Dubost et. al., eds. <a href="http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/">
+ <cite>QA Framework: Specification Guidelines.</cite></a>, August 2005. W3C Recommendation.
+ URL: <a href="http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/">http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/</a></dd>
<dt id="bib-ATAGB3">[ATAGB3]</dt>
<dd>Jutta Treviranus et. al., eds. <a href="http://www.w3.org/TR/ATAG20-TECHS/#principle_b3"><cite>Implementing
ATAG 2.0</cite></a>, Principle B3 "Authors must be supported
@@ -820,7 +827,7 @@
<ul>
<li>Explicitly stating that <code>longdesc</code> makes a limited
change to the semantics of the term "hyperlink" in HTML</li>
- <li>Editing of the non-normative guidance in various places.</li>
+ <li>Editing of the informative guidance in various places.</li>
<li>Explicitly adding a reference to the software license to allow
people to re-use the code samples and IDL more easily with fewer
restrictions.</li>