changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
authorMark Sadecki <mark@w3.org>
Sat, 14 Dec 2013 12:45:39 -0500
changeset 71 b47874bf45dd
parent 70 ccd4d8ef941e
child 72 7fb44d0e1473
changed "non-normative" to "informative", linked to definitions, added ref to QAFRAME - See bug 24047
longdesc1/longdesc.html
--- 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>