Browse files

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

git-svn-id: http://svn.whatwg.org/webapps@2424 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
1 parent 2e21079 commit 59f3da38f94559e24d0c6551cd49215fa1c4f961 @Hixie Hixie committed Nov 20, 2008
Showing with 71 additions and 22 deletions.
  1. +47 −22 index
  2. +24 −0 source
View
69 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>
View
24 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>

0 comments on commit 59f3da3

Please sign in to comment.