[e] (0) Add the Audience section to the intro.

git-svn-id: http://svn.whatwg.org/webapps@2424 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Nov 20, 2008 · 59f3da3 · 59f3da3
1 parent 2e21079
commit 59f3da3
Show file tree

Hide file tree

Showing 2 changed files with 71 additions and 22 deletions.
diff --git a/index b/index
@@ -183,20 +183,21 @@
  <li><a href=#introduction><span class=secno>1 </span>Introduction</a>
   <ol>
    <li><a href=#background><span class=secno>1.1 </span>Background</a></li>
-   <li><a href=#scope><span class=secno>1.2 </span>Scope</a></li>
-   <li><a href=#history-0><span class=secno>1.3 </span>History</a></li>
-   <li><a href=#relationships-to-other-specifications><span class=secno>1.4 </span>Relationships to other specifications</a>
+   <li><a href=#audience><span class=secno>1.2 </span>Audience</a></li>
+   <li><a href=#scope><span class=secno>1.3 </span>Scope</a></li>
+   <li><a href=#history-0><span class=secno>1.4 </span>History</a></li>
+   <li><a href=#relationships-to-other-specifications><span class=secno>1.5 </span>Relationships to other specifications</a>
     <ol>
-     <li><a href=#relationship-to-html-4.01-and-dom2-html><span class=secno>1.4.1 </span>Relationship to HTML 4.01 and DOM2 HTML</a></li>
-     <li><a href=#relationship-to-xhtml-1.x><span class=secno>1.4.2 </span>Relationship to XHTML 1.x</a></li>
-     <li><a href=#relationship-to-xhtml2-and-xforms><span class=secno>1.4.3 </span>Relationship to XHTML2 and XForms</a></li>
-     <li><a href=#relationship-to-flash,-silverlight,-xul-and-similar-proprietary-languages><span class=secno>1.4.4 </span>Relationship to Flash, Silverlight, XUL <!-- alphabetical -->
+     <li><a href=#relationship-to-html-4.01-and-dom2-html><span class=secno>1.5.1 </span>Relationship to HTML 4.01 and DOM2 HTML</a></li>
+     <li><a href=#relationship-to-xhtml-1.x><span class=secno>1.5.2 </span>Relationship to XHTML 1.x</a></li>
+     <li><a href=#relationship-to-xhtml2-and-xforms><span class=secno>1.5.3 </span>Relationship to XHTML2 and XForms</a></li>
+     <li><a href=#relationship-to-flash,-silverlight,-xul-and-similar-proprietary-languages><span class=secno>1.5.4 </span>Relationship to Flash, Silverlight, XUL <!-- alphabetical -->
   and similar proprietary languages</a></ol></li>
-   <li><a href=#html-vs-xhtml><span class=secno>1.5 </span>HTML vs XHTML</a></li>
-   <li><a href=#structure-of-this-specification><span class=secno>1.6 </span>Structure of this specification</a>
+   <li><a href=#html-vs-xhtml><span class=secno>1.6 </span>HTML vs XHTML</a></li>
+   <li><a href=#structure-of-this-specification><span class=secno>1.7 </span>Structure of this specification</a>
     <ol>
-     <li><a href=#how-to-read-this-specification><span class=secno>1.6.1 </span>How to read this specification</a></li>
-     <li><a href=#typographic-conventions><span class=secno>1.6.2 </span>Typographic conventions</a></ol></ol></li>
+     <li><a href=#how-to-read-this-specification><span class=secno>1.7.1 </span>How to read this specification</a></li>
+     <li><a href=#typographic-conventions><span class=secno>1.7.2 </span>Typographic conventions</a></ol></ol></li>
  <li><a href=#infrastructure><span class=secno>2 </span>Common infrastructure</a>
   <ol>
    <li><a href=#terminology><span class=secno>2.1 </span>Terminology</a>
@@ -1003,7 +1004,31 @@
   specifications to address issues raised in the past few years.</p>
 
 
-  <h3 id=scope><span class=secno>1.2 </span>Scope</h3>
+  <h3 id=audience><span class=secno>1.2 </span>Audience</h3>
+
+  <p><em>This section is non-normative.</em></p>
+
+  <p>This specification is intended for authors of documents and
+  scripts that use the features defined in this specificaton, and
+  implementors of tools that are intended to conform to this
+  specification, and individuals wishing to establish the correctness
+  of documents or implementations with respect to the requirements of
+  this specification.</p>
+
+  <p>This document is probably not suited to readers who do not
+  already have at least a passing familiarity with Web technologies,
+  as in places it sacrifices clarity for precision, and brevity for
+  completeness. More approachable tutorials and authoring guides can
+  provide a gentler introduction to the topic.</p>
+
+  <p>In particular, readers should be familiar with the basics of DOM
+  Core and DOM Events before reading this specification. An
+  understanding of WebIDL, HTTP, XML, Unicode, character encodings,
+  JavaScript, and CSS will be helpful in places but is not
+  essential.</p>
+
+
+  <h3 id=scope><span class=secno>1.3 </span>Scope</h3>
 
   <p><em>This section is non-normative.</em></p>
 
@@ -1050,7 +1075,7 @@
   ahead.</p>
 
 
-  <h3 id=history-0><span class=secno>1.3 </span>History</h3>
+  <h3 id=history-0><span class=secno>1.4 </span>History</h3>
 
   <p><em>This section is non-normative.</em></p>
 
@@ -1087,9 +1112,9 @@
 
 
 
-  <h3 id=relationships-to-other-specifications><span class=secno>1.4 </span>Relationships to other specifications</h3>
+  <h3 id=relationships-to-other-specifications><span class=secno>1.5 </span>Relationships to other specifications</h3>
 
-  <h4 id=relationship-to-html-4.01-and-dom2-html><span class=secno>1.4.1 </span>Relationship to HTML 4.01 and DOM2 HTML</h4>
+  <h4 id=relationship-to-html-4.01-and-dom2-html><span class=secno>1.5.1 </span>Relationship to HTML 4.01 and DOM2 HTML</h4>
 
   <p><em>This section is non-normative.</em></p>
 
@@ -1100,7 +1125,7 @@
   backwards-compatibility is retained. <a href=#refsHTML4>[HTML4]</a> <a href=#refsDOM2HTML>[DOM2HTML]</a></p>
 
 
-  <h4 id=relationship-to-xhtml-1.x><span class=secno>1.4.2 </span>Relationship to XHTML 1.x</h4>
+  <h4 id=relationship-to-xhtml-1.x><span class=secno>1.5.2 </span>Relationship to XHTML 1.x</h4>
 
   <p><em>This section is non-normative.</em></p>
 
@@ -1121,7 +1146,7 @@
   to continue using the XHTML 1.1 line of specifications.</p>
 
 
-  <h4 id=relationship-to-xhtml2-and-xforms><span class=secno>1.4.3 </span>Relationship to XHTML2 and XForms</h4>
+  <h4 id=relationship-to-xhtml2-and-xforms><span class=secno>1.5.3 </span>Relationship to XHTML2 and XForms</h4>
 
   <p><em>This section is non-normative.</em></p>
 
@@ -1148,7 +1173,7 @@
   processor.</p>
 
 
-  <h4 id=relationship-to-flash,-silverlight,-xul-and-similar-proprietary-languages><span class=secno>1.4.4 </span>Relationship to Flash, Silverlight, XUL <!-- alphabetical -->
+  <h4 id=relationship-to-flash,-silverlight,-xul-and-similar-proprietary-languages><span class=secno>1.5.4 </span>Relationship to Flash, Silverlight, XUL <!-- alphabetical -->
   and similar proprietary languages</h4>
 
   <p><em>This section is non-normative.</em></p>
@@ -1171,7 +1196,7 @@
   cost.</p>
 
 
-  <h3 id=html-vs-xhtml><span class=secno>1.5 </span>HTML vs XHTML</h3>
+  <h3 id=html-vs-xhtml><span class=secno>1.6 </span>HTML vs XHTML</h3>
 
   <p><em>This section is non-normative.</em></p>
 
@@ -1210,7 +1235,7 @@
   not in "HTML5" and "XHTML5". And so forth.</p>
 
 
-  <h3 id=structure-of-this-specification><span class=secno>1.6 </span>Structure of this specification</h3>
+  <h3 id=structure-of-this-specification><span class=secno>1.7 </span>Structure of this specification</h3>
 
   <p><em>This section is non-normative.</em></p>
 
@@ -1274,7 +1299,7 @@
   specification.</p>
 
 
-  <h4 id=how-to-read-this-specification><span class=secno>1.6.1 </span>How to read this specification</h4>
+  <h4 id=how-to-read-this-specification><span class=secno>1.7.1 </span>How to read this specification</h4>
 
   <p>This specification should be read like all other specifications.
   First, it should be read cover-to-cover, multiple times. Then, it
@@ -1283,7 +1308,7 @@
   cross-references.</p>
 
 
-  <h4 id=typographic-conventions><span class=secno>1.6.2 </span>Typographic conventions</h4>
+  <h4 id=typographic-conventions><span class=secno>1.7.2 </span>Typographic conventions</h4>
 
   <p>This is a definition, requirement, or explanation.</p>
 

diff --git a/source b/source
@@ -38,6 +38,30 @@
   specifications to address issues raised in the past few years.</p>
 
 
+  <h3>Audience</h3>
+
+  <p><em>This section is non-normative.</em></p>
+
+  <p>This specification is intended for authors of documents and
+  scripts that use the features defined in this specificaton, and
+  implementors of tools that are intended to conform to this
+  specification, and individuals wishing to establish the correctness
+  of documents or implementations with respect to the requirements of
+  this specification.</p>
+
+  <p>This document is probably not suited to readers who do not
+  already have at least a passing familiarity with Web technologies,
+  as in places it sacrifices clarity for precision, and brevity for
+  completeness. More approachable tutorials and authoring guides can
+  provide a gentler introduction to the topic.</p>
+
+  <p>In particular, readers should be familiar with the basics of DOM
+  Core and DOM Events before reading this specification. An
+  understanding of WebIDL, HTTP, XML, Unicode, character encodings,
+  JavaScript, and CSS will be helpful in places but is not
+  essential.</p>
+
+
   <h3>Scope</h3>
 
   <p><em>This section is non-normative.</em></p>