[html5] r2424 - [e] (0) Add the Audience section to the intro.
whatwg at whatwg.org
whatwg at whatwg.org
Thu Nov 20 05:28:13 PST 2008
Author: ianh
Date: 2008-11-20 05:28:12 -0800 (Thu, 20 Nov 2008)
New Revision: 2424
Modified:
index
source
Log:
[e] (0) Add the Audience section to the intro.
Modified: index
===================================================================
--- index 2008-11-20 02:52:45 UTC (rev 2423)
+++ index 2008-11-20 13:28:12 UTC (rev 2424)
@@ -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,10 +1004,34 @@
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>
+
<p>This specification is limited to providing a semantic-level
markup language and associated semantic-level scripting APIs for
authoring accessible pages on the Web ranging from static documents
@@ -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>
Modified: source
===================================================================
--- source 2008-11-20 02:52:45 UTC (rev 2423)
+++ source 2008-11-20 13:28:12 UTC (rev 2424)
@@ -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>
More information about the Commit-Watchers
mailing list