Say what's normative and what's not
authorAryeh Gregor <ayg@aryeh.name>
Mon, 05 Mar 2012 10:33:40 -0700
changeset 709 1b07a32aae70
parent 708 3776dec493c5
child 710 52c84909f3b3
Say what's normative and what's not

Fixes: https://www.w3.org/Bugs/Public/show_bug.cgi?id=16206
Reported-By: Ryosuke Niwa
editing.html
source.html
--- a/editing.html	Thu Mar 01 12:16:56 2012 -0700
+++ b/editing.html	Mon Mar 05 10:33:40 2012 -0700
@@ -67,7 +67,7 @@
 <body class=draft>
 <div class=head id=head>
 <h1>HTML Editing APIs</h1>
-<h2 class="no-num no-toc" id=work-in-progress-&mdash;-last-update-1-march-2012>Work in Progress &mdash; Last Update 1 March 2012</h2>
+<h2 class="no-num no-toc" id=work-in-progress-&mdash;-last-update-5-march-2012>Work in Progress &mdash; Last Update 5 March 2012</h2>
 <dl>
  <dt>Editor
  <dd>Aryeh Gregor &lt;<a href=mailto:[email protected]>[email protected]</a>&gt;
@@ -208,6 +208,25 @@
 
 <h2 id=introduction>Introduction</h2>
 
+<p class=comments>
+<a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16206">Bug 16206</a>.
+
+<p>A piece of software that claims to implement this specification must follow
+every <dfn id=normative>normative</dfn> requirement in it.  Every requirement in this
+specification is <a href=#normative>normative</a> unless stated otherwise.
+
+<p class=comments>These are comments.  All comments other than this one are
+non-<a href=#normative>normative</a>.
+
+<p class=note>This is a note.  All notes other than this one are
+non-<a href=#normative>normative</a>.
+
+<p class=XXX>This is an open issue.  All issues other than this one are
+non-<a href=#normative>normative</a>.
+
+<p>The remainder of this section is not <a href=#normative>normative</a>, and nor is any
+preceding section.
+
 <p>This specification defines commands to edit HTML documents programmatically.
 The APIs specified here were originally introduced in Microsoft's Internet
 Explorer, but have subsequently been copied by other browsers in a haphazard
@@ -281,16 +300,18 @@
 
 <h2 id=tests>Tests</h2>
 
+<p><i title="">This section is not <a href=#normative>normative</a>.</i>
+
 <h3 id=general-remarks>General remarks</h3>
 
 
 <p>There are two groups of tests currently associated with this document:
-selection tests, and command tests.  These tests are a non-normative part of
-this specification.  The command tests are available in two formats,
-development tests and conformance tests.  This has a lot to do with the history
-of how the specification was developed: selection was originally part of the
-defunct <a href=http://html5.org/specs/dom-range.html>DOM Range</a> spec, while
-the command parts were developed on their own.  The selection things have been
+selection tests, and command tests.  These tests are a
+non-<a href=#normative>normative</a> part of this specification.  The command tests are
+available in two formats, development tests and conformance tests.  This has a
+lot to do with the history of how the specification was developed: selection
+was originally part of the defunct <a href=http://html5.org/specs/dom-range.html>DOM Range</a> spec, while the
+command parts were developed on their own.  The selection things have been
 merged into the command spec, but neither the spec text nor the tests have been
 fully unified at the time of this writing.
 
@@ -541,6 +562,8 @@
 
 <h2 id=issues>Issues</h2>
 
+<p><i title="">This section is not <a href=#normative>normative</a>.</i>
+
 <p>This specification is mostly feature-complete.  It's more or less fully
 implemented in JavaScript, and has been tested on a fairly significant amount
 of artificial input.  It has not been tested on real-world sites that use
@@ -10358,6 +10381,8 @@
 
 <h2 class=no-num id=acknowledgements>Acknowledgements</h2>
 
+<p><i title="">This section is not <a href=#normative>normative</a>.</i>
+
 <p>Thanks to:
 
 <ul>
--- a/source.html	Thu Mar 01 12:16:56 2012 -0700
+++ b/source.html	Mon Mar 05 10:33:40 2012 -0700
@@ -124,6 +124,25 @@
 
 <h2>Introduction</h2>
 <!-- @{ -->
+<p class=comments>
+<a href=https://www.w3.org/Bugs/Public/show_bug.cgi?id=16206>Bug 16206</a>.
+
+<p>A piece of software that claims to implement this specification must follow
+every <dfn>normative</dfn> requirement in it.  Every requirement in this
+specification is <span>normative</span> unless stated otherwise.
+
+<p class=comments>These are comments.  All comments other than this one are
+non-<span>normative</span>.
+
+<p class=note>This is a note.  All notes other than this one are
+non-<span>normative</span>.
+
+<p class=XXX>This is an open issue.  All issues other than this one are
+non-<span>normative</span>.
+
+<p>The remainder of this section is not <span>normative</span>, and nor is any
+preceding section.
+
 <p>This specification defines commands to edit HTML documents programmatically.
 The APIs specified here were originally introduced in Microsoft's Internet
 Explorer, but have subsequently been copied by other browsers in a haphazard
@@ -197,16 +216,19 @@
 
 <h2>Tests</h2>
 
+<p><i title>This section is not <span>normative</span>.</i>
+
 <h3>General remarks</h3>
 <!-- @{ -->
 
 <p>There are two groups of tests currently associated with this document:
-selection tests, and command tests.  These tests are a non-normative part of
-this specification.  The command tests are available in two formats,
-development tests and conformance tests.  This has a lot to do with the history
-of how the specification was developed: selection was originally part of the
-defunct <a href=http://html5.org/specs/dom-range.html>DOM Range</a> spec, while
-the command parts were developed on their own.  The selection things have been
+selection tests, and command tests.  These tests are a
+non-<span>normative</span> part of this specification.  The command tests are
+available in two formats, development tests and conformance tests.  This has a
+lot to do with the history of how the specification was developed: selection
+was originally part of the defunct <a
+href=http://html5.org/specs/dom-range.html>DOM Range</a> spec, while the
+command parts were developed on their own.  The selection things have been
 merged into the command spec, but neither the spec text nor the tests have been
 fully unified at the time of this writing.
 
@@ -474,6 +496,8 @@
 
 <h2>Issues</h2>
 <!-- @{ -->
+<p><i title>This section is not <span>normative</span>.</i>
+
 <p>This specification is mostly feature-complete.  It's more or less fully
 implemented in JavaScript, and has been tested on a fairly significant amount
 of artificial input.  It has not been tested on real-world sites that use
@@ -10480,6 +10504,8 @@
 
 <h2 class=no-num>Acknowledgements</h2>
 <!-- @{ -->
+<p><i title>This section is not <span>normative</span>.</i>
+
 <p>Thanks to:
 
 <ul>