Skip to content
Permalink
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...
Hixie committed Nov 20, 2008
1 parent 2e21079 commit 59f3da38f94559e24d0c6551cd49215fa1c4f961
Showing with 71 additions and 22 deletions.
  1. +47 −22 index
  2. +24 −0 source
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>

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.
You can’t perform that action at this time.