Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[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 59f3da3
Show file tree
Hide file tree
Showing 2 changed files with 71 additions and 22 deletions.
69 changes: 47 additions & 22 deletions index
Expand Up @@ -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>
Expand Down Expand Up @@ -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>

Expand Down Expand Up @@ -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>

Expand Down Expand Up @@ -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>

Expand All @@ -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>

Expand All @@ -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>

Expand All @@ -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>
Expand All @@ -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>

Expand Down Expand Up @@ -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>

Expand Down Expand Up @@ -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
Expand All @@ -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>

Expand Down
24 changes: 24 additions & 0 deletions source
Expand Up @@ -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>
Expand Down

0 comments on commit 59f3da3

Please sign in to comment.