[html5] r3043 - [e] (0) Attempt to resolve the terminology confusion of heading vs header.
whatwg at whatwg.org
whatwg at whatwg.org
Thu Apr 30 12:04:05 PDT 2009
Author: ianh
Date: 2009-04-30 12:04:04 -0700 (Thu, 30 Apr 2009)
New Revision: 3043
Modified:
index
source
Log:
[e] (0) Attempt to resolve the terminology confusion of heading vs header.
Modified: index
===================================================================
--- index 2009-04-30 18:43:25 UTC (rev 3042)
+++ index 2009-04-30 19:04:04 UTC (rev 3043)
@@ -8619,7 +8619,7 @@
<h5 id=sectioning-content><span class=secno>3.4.1.3 </span>Sectioning content</h5>
<p><dfn id=sectioning-content-0>Sectioning content</dfn> is content that defines the scope
- of <a href=#heading-content-0 title="heading content">headers</a>, <a href=#the-footer-element title=footer>footers</a>, and <a href=#the-address-element title=address>contact
+ of <a href=#heading-content-0 title="heading content">headings</a>, <a href=#the-footer-element title=footer>footers</a>, and <a href=#the-address-element title=address>contact
information</a>.</p>
<p>Each <a href=#sectioning-content-0>sectioning content</a> element potentially has a
@@ -8857,7 +8857,7 @@
<div class=example>
<p>In the following example, there are two paragraphs in a
- section. There is also a header, which contains phrasing content
+ section. There is also a heading, which contains phrasing content
that is not a paragraph. Note how the comments and
<a href=#inter-element-whitespace>inter-element whitespace</a> do not form paragraphs.</p>
@@ -8887,7 +8887,7 @@
<div class=example>
<p>In the following example, the link spans half of the first
- paragraph, all of the header separating the two paragraphs, and
+ paragraph, all of the heading separating the two paragraphs, and
half of the second paragraph.</p>
<pre><aside>
@@ -9858,8 +9858,8 @@
document's title or name. Authors should use titles that identify
their documents even when they are used out of context, for example
in a user's history or bookmarks, or in search results. The
- document's title is often different from its first header, since the
- first header does not have to stand alone when taken out of
+ document's title is often different from its first heading, since the
+ first heading does not have to stand alone when taken out of
context.</p>
<p>There must be no more than one <code><a href=#the-title-element>title</a></code> element per
@@ -9871,7 +9871,7 @@
<div class=example>
<p>Here are some examples of appropriate titles, contrasted with
- the top-level headers that might be used on those same pages.</p>
+ the top-level headings that might be used on those same pages.</p>
<pre> <title>Introduction to The Mating Rituals of Bees</title>
...
@@ -9882,7 +9882,7 @@
<p>The next page might be a part of the same site. Note how the
title describes the subject matter unambiguously, while the first
- header assumes the reader knows what the context is and therefore
+ heading assumes the reader knows what the context is and therefore
won't wonder if the dances are Salsa or Waltz:</p>
<pre> <title>Dances used during bee mating rituals</title>
@@ -12115,7 +12115,7 @@
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
</dl><p>The <code><a href=#the-section-element>section</a></code> element <a href=#represents>represents</a> a
generic document or application section. A section, in this context,
- is a thematic grouping of content, typically with a header, possibly
+ is a thematic grouping of content, typically with a heading, possibly
with a footer.</p>
<p class=example>Examples of sections would be chapters, the
@@ -12335,7 +12335,7 @@
<dd><a href=#global-attributes>Global attributes</a></dd>
<dt>DOM interface:</dt>
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
- </dl><p>These elements <a href=#represents title=represents>represent</a> headers
+ </dl><p>These elements <a href=#represents title=represents>represent</a> headings
for their sections.</p>
<p>The semantics and meaning of these elements are defined in the
@@ -12361,8 +12361,8 @@
<dt>DOM interface:</dt>
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
</dl><p>The <code><a href=#the-hgroup-element>hgroup</a></code> element <a href=#represents>represents</a> the
- header of a section. The element is used to group a set of
- <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> elements when the header has
+ heading of a section. The element is used to group a set of
+ <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> elements when the heading has
multiple levels, such as subheadings, alternative titles, or
taglines.</p>
@@ -12375,8 +12375,8 @@
<a href=#rank>rank</a>. If there are no such elements, then the text of
the <code><a href=#the-hgroup-element>hgroup</a></code> element is the empty string.</p>
- <p>Other heading elements in the <code><a href=#the-hgroup-element>hgroup</a></code> element
- indicate subheadings or subtitles.</p>
+ <p>Other elements of <a href=#heading-content-0>heading content</a> in the
+ <code><a href=#the-hgroup-element>hgroup</a></code> element indicate subheadings or subtitles.</p>
<p>The <a href=#rank>rank</a> of an <code><a href=#the-hgroup-element>hgroup</a></code> element is the
same as for an <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code> element (the highest rank).</p>
@@ -12387,9 +12387,9 @@
<div class=example>
- <p>Here are some examples of valid headers. In each case, the
+ <p>Here are some examples of valid headings. In each case, the
emphasized text represents the text that would be used as the
- header in an application extracting header data and ignoring
+ heading in an application extracting heading data and ignoring
subheadings.</p>
<pre><hgroup>
@@ -12419,17 +12419,13 @@
<dt>DOM interface:</dt>
<dd>Uses <code><a href=#htmlelement>HTMLElement</a></code>.</dd>
</dl><p>The <code><a href=#the-header-element>header</a></code> element <a href=#represents>represents</a> a group
- of introductory or navigational aids for the section it <a href=#applyToSection>applies</a> to. A <code><a href=#the-header-element>header</a></code> element
- typically contains the section's header (an
+ of introductory or navigational aids. A <code><a href=#the-header-element>header</a></code> element
+ typically contains the section's heading (an
<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>–<code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> element or an
<code><a href=#the-hgroup-element>hgroup</a></code> element), but can also contain other content,
such as a table of contents, a search form, or any relevant
logos.</p>
- <p>Contact information for the section to which the
- <code><a href=#the-header-element>header</a></code> element <a href=#applyToSection>applies</a>
- should be marked up using the <code><a href=#the-address-element>address</a></code> element.</p>
-
<div class=example>
<p>Here are some sample headers. This first one is for a game:</p>
@@ -12440,7 +12436,7 @@
</header></pre>
<p>The following snippet shows how the element can be used to mark
- up a specification's heading:</p>
+ up a specification's header:</p>
<pre><header>
<hgroup>
@@ -12534,7 +12530,7 @@
<p>The <code><a href=#the-footer-element>footer</a></code> element is inappropriate for containing
entire sections. For appendices, indexes, long colophons, verbose
license agreements, and other such content which needs sectioning
- with headers and so forth, regular <code><a href=#the-section-element>section</a></code> elements
+ with headings and so forth, regular <code><a href=#the-section-element>section</a></code> elements
should be used, not a <code><a href=#the-footer-element>footer</a></code>.</p>
<div class=example>
@@ -12635,11 +12631,11 @@
<p>The first element of <a href=#heading-content-0>heading content</a> in an element
of <a href=#sectioning-content-0>sectioning content</a> <a href=#represents>represents</a> the
- header for that section. Subsequent headers of equal or higher
- <a href=#rank>rank</a> start new (implied) sections, headers of lower
+ heading for that section. Subsequent headings of equal or higher
+ <a href=#rank>rank</a> start new (implied) sections, headings of lower
<a href=#rank>rank</a> start implied subsections that are part of the
previous one. In both cases, the element <a href=#represents>represents</a> the
- header of the implied section.</p>
+ heading of the implied section.</p>
<p><a href=#sectioning-content-0>Sectioning content</a> elements are always considered
subsections of their nearest ancestor element of <a href=#sectioning-content-0>sectioning
@@ -12649,7 +12645,7 @@
<p>Certain elements are said to be <dfn id=sectioning-root title="sectioning
root">sectioning roots</dfn>, including <code><a href=#the-blockquote-element>blockquote</a></code> and
<code><a href=#the-td-element>td</a></code> elements. These elements can have their own
- outlines, but the sections and headers inside these elements do not
+ outlines, but the sections and headings inside these elements do not
contribute to the outlines of their ancestors.</p>
<div class=example>
@@ -12685,7 +12681,7 @@
level.</p>
</div>
- <p>Sections may contain headers of any <a href=#rank>rank</a>, but
+ <p>Sections may contain headings of any <a href=#rank>rank</a>, but
authors are strongly encouraged to either use only <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code>
elements, or to use elements of the appropriate <a href=#rank>rank</a>
for the section's nesting level.</p>
@@ -13011,7 +13007,7 @@
<p class=note>Selecting the first <a href=#concept-section title=concept-section>section</a> of the document therefore
always takes the user to the top of the document, regardless of
- where the first header in the <code><a href=#the-body-element>body</a></code> is to be found.</p>
+ where the first heading in the <code><a href=#the-body-element>body</a></code> is to be found.</p>
<!-- XXX assuming there is a body, anyway -->
<div class=note>
@@ -16143,7 +16139,7 @@
</div>
<p>The <code><a href=#the-b-element>b</a></code> element should be used as a last resort when
- no other element is more appropriate. In particular, headers should
+ no other element is more appropriate. In particular, headings should
use the <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h1</a></code> to <code><a href=#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements>h6</a></code> elements, stress emphasis
should use the <code><a href=#the-em-element>em</a></code> element, importance should be denoted
with the <code><a href=#the-strong-element>strong</a></code> element, and text marked or highlighted
@@ -17578,7 +17574,7 @@
project, band, software package, country, or some such.</p>
<p>If the logo is being used to represent the entity, e.g. as a page
- header, the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute must
+ heading, the <code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute must
contain the name of the entity being represented by the logo. The
<code title=attr-img-alt><a href=#attr-img-alt>alt</a></code> attribute must <em>not</em>
contain text like the word "logo", as it is not the fact that it is
@@ -17660,11 +17656,11 @@
<p>Consider a graphic containing the text "Earth Day", but with the
letters all decorated with flowers and plants. If the text is
- merely being used as a header, to spice up the page for graphical
+ merely being used as a heading, to spice up the page for graphical
users, then the correct alternative text is just the same text
"Earth Day", and no mention need be made of the decorations:</p>
- <pre><h1><strong><img src="earthdayheader.png" alt="Earth Day"></strong></h1></pre>
+ <pre><h1><strong><img src="earthdayheading.png" alt="Earth Day"></strong></h1></pre>
</div>
@@ -61845,9 +61841,9 @@
}
address, article, aside, blockquote, body, center, dd, dialog, dir,
-div, dl, dt, figure, footer, form, h1, h2, h3, h4, h5, h6, header, hr,
-html, legend, listing, menu, nav, ol, p, plaintext, pre, rp, section,
-ul, xmp { display: block; }
+div, dl, dt, figure, footer, form, h1, h2, h3, h4, h5, h6, header,
+hgroup, hr, html, legend, listing, menu, nav, ol, p, plaintext, pre,
+rp, section, ul, xmp { display: block; }
table { display: table; }
caption { display: table-caption; }
Modified: source
===================================================================
--- source 2009-04-30 18:43:25 UTC (rev 3042)
+++ source 2009-04-30 19:04:04 UTC (rev 3043)
@@ -8938,7 +8938,7 @@
<h5>Sectioning content</h5>
<p><dfn>Sectioning content</dfn> is content that defines the scope
- of <span title="heading content">headers</span>, <span
+ of <span title="heading content">headings</span>, <span
title="footer">footers</span>, and <span title="address">contact
information</span>.</p>
@@ -9195,7 +9195,7 @@
<div class="example">
<p>In the following example, there are two paragraphs in a
- section. There is also a header, which contains phrasing content
+ section. There is also a heading, which contains phrasing content
that is not a paragraph. Note how the comments and
<span>inter-element whitespace</span> do not form paragraphs.</p>
@@ -9225,7 +9225,7 @@
<div class="example">
<p>In the following example, the link spans half of the first
- paragraph, all of the header separating the two paragraphs, and
+ paragraph, all of the heading separating the two paragraphs, and
half of the second paragraph.</p>
<pre><aside>
@@ -10325,8 +10325,8 @@
document's title or name. Authors should use titles that identify
their documents even when they are used out of context, for example
in a user's history or bookmarks, or in search results. The
- document's title is often different from its first header, since the
- first header does not have to stand alone when taken out of
+ document's title is often different from its first heading, since the
+ first heading does not have to stand alone when taken out of
context.</p>
<p>There must be no more than one <code>title</code> element per
@@ -10338,7 +10338,7 @@
<div class="example">
<p>Here are some examples of appropriate titles, contrasted with
- the top-level headers that might be used on those same pages.</p>
+ the top-level headings that might be used on those same pages.</p>
<pre> <title>Introduction to The Mating Rituals of Bees</title>
...
@@ -10349,7 +10349,7 @@
<p>The next page might be a part of the same site. Note how the
title describes the subject matter unambiguously, while the first
- header assumes the reader knows what the context is and therefore
+ heading assumes the reader knows what the context is and therefore
won't wonder if the dances are Salsa or Waltz:</p>
<pre> <title>Dances used during bee mating rituals</title>
@@ -12947,7 +12947,7 @@
<p>The <code>section</code> element <span>represents</span> a
generic document or application section. A section, in this context,
- is a thematic grouping of content, typically with a header, possibly
+ is a thematic grouping of content, typically with a heading, possibly
with a footer.</p>
<p class="example">Examples of sections would be chapters, the
@@ -13180,7 +13180,7 @@
<dd>Uses <code>HTMLElement</code>.</dd>
</dl>
- <p>These elements <span title="represents">represent</span> headers
+ <p>These elements <span title="represents">represent</span> headings
for their sections.</p>
<p>The semantics and meaning of these elements are defined in the
@@ -13209,8 +13209,8 @@
</dl>
<p>The <code>hgroup</code> element <span>represents</span> the
- header of a section. The element is used to group a set of
- <code>h1</code>–<code>h6</code> elements when the header has
+ heading of a section. The element is used to group a set of
+ <code>h1</code>–<code>h6</code> elements when the heading has
multiple levels, such as subheadings, alternative titles, or
taglines.</p>
@@ -13223,8 +13223,8 @@
<span>rank</span>. If there are no such elements, then the text of
the <code>hgroup</code> element is the empty string.</p>
- <p>Other heading elements in the <code>hgroup</code> element
- indicate subheadings or subtitles.</p>
+ <p>Other elements of <span>heading content</span> in the
+ <code>hgroup</code> element indicate subheadings or subtitles.</p>
<p>The <span>rank</span> of an <code>hgroup</code> element is the
same as for an <code>h1</code> element (the highest rank).</p>
@@ -13235,9 +13235,9 @@
<div class="example">
- <p>Here are some examples of valid headers. In each case, the
+ <p>Here are some examples of valid headings. In each case, the
emphasized text represents the text that would be used as the
- header in an application extracting header data and ignoring
+ heading in an application extracting heading data and ignoring
subheadings.</p>
<pre><hgroup>
@@ -13270,18 +13270,13 @@
</dl>
<p>The <code>header</code> element <span>represents</span> a group
- of introductory or navigational aids for the section it <a
- href="#applyToSection">applies</a> to. A <code>header</code> element
- typically contains the section's header (an
+ of introductory or navigational aids. A <code>header</code> element
+ typically contains the section's heading (an
<code>h1</code>–<code>h6</code> element or an
<code>hgroup</code> element), but can also contain other content,
such as a table of contents, a search form, or any relevant
logos.</p>
- <p>Contact information for the section to which the
- <code>header</code> element <a href="#applyToSection">applies</a>
- should be marked up using the <code>address</code> element.</p>
-
<div class="example">
<p>Here are some sample headers. This first one is for a game:</p>
@@ -13292,7 +13287,7 @@
</header></pre>
<p>The following snippet shows how the element can be used to mark
- up a specification's heading:</p>
+ up a specification's header:</p>
<pre><header>
<hgroup>
@@ -13389,7 +13384,7 @@
<p>The <code>footer</code> element is inappropriate for containing
entire sections. For appendices, indexes, long colophons, verbose
license agreements, and other such content which needs sectioning
- with headers and so forth, regular <code>section</code> elements
+ with headings and so forth, regular <code>section</code> elements
should be used, not a <code>footer</code>.</p>
<div class="example">
@@ -13495,11 +13490,11 @@
<p>The first element of <span>heading content</span> in an element
of <span>sectioning content</span> <span>represents</span> the
- header for that section. Subsequent headers of equal or higher
- <span>rank</span> start new (implied) sections, headers of lower
+ heading for that section. Subsequent headings of equal or higher
+ <span>rank</span> start new (implied) sections, headings of lower
<span>rank</span> start implied subsections that are part of the
previous one. In both cases, the element <span>represents</span> the
- header of the implied section.</p>
+ heading of the implied section.</p>
<p><span>Sectioning content</span> elements are always considered
subsections of their nearest ancestor element of <span>sectioning
@@ -13509,7 +13504,7 @@
<p>Certain elements are said to be <dfn title="sectioning
root">sectioning roots</dfn>, including <code>blockquote</code> and
<code>td</code> elements. These elements can have their own
- outlines, but the sections and headers inside these elements do not
+ outlines, but the sections and headings inside these elements do not
contribute to the outlines of their ancestors.</p>
<div class="example">
@@ -13549,7 +13544,7 @@
level.</p>
</div>
- <p>Sections may contain headers of any <span>rank</span>, but
+ <p>Sections may contain headings of any <span>rank</span>, but
authors are strongly encouraged to either use only <code>h1</code>
elements, or to use elements of the appropriate <span>rank</span>
for the section's nesting level.</p>
@@ -13922,7 +13917,7 @@
<p class="note">Selecting the first <span
title="concept-section">section</span> of the document therefore
always takes the user to the top of the document, regardless of
- where the first header in the <code>body</code> is to be found.</p>
+ where the first heading in the <code>body</code> is to be found.</p>
<!-- XXX assuming there is a body, anyway -->
<div class="note">
@@ -17334,7 +17329,7 @@
</div>
<p>The <code>b</code> element should be used as a last resort when
- no other element is more appropriate. In particular, headers should
+ no other element is more appropriate. In particular, headings should
use the <code>h1</code> to <code>h6</code> elements, stress emphasis
should use the <code>em</code> element, importance should be denoted
with the <code>strong</code> element, and text marked or highlighted
@@ -18881,7 +18876,7 @@
project, band, software package, country, or some such.</p>
<p>If the logo is being used to represent the entity, e.g. as a page
- header, the <code title="attr-img-alt">alt</code> attribute must
+ heading, the <code title="attr-img-alt">alt</code> attribute must
contain the name of the entity being represented by the logo. The
<code title="attr-img-alt">alt</code> attribute must <em>not</em>
contain text like the word "logo", as it is not the fact that it is
@@ -18964,11 +18959,11 @@
<p>Consider a graphic containing the text "Earth Day", but with the
letters all decorated with flowers and plants. If the text is
- merely being used as a header, to spice up the page for graphical
+ merely being used as a heading, to spice up the page for graphical
users, then the correct alternative text is just the same text
"Earth Day", and no mention need be made of the decorations:</p>
- <pre><h1><strong><img src="earthdayheader.png" alt="Earth Day"></strong></h1></pre>
+ <pre><h1><strong><img src="earthdayheading.png" alt="Earth Day"></strong></h1></pre>
</div>
@@ -72677,9 +72672,9 @@
}
address, article, aside, blockquote, body, center, dd, dialog, dir,
-div, dl, dt, figure, footer, form, h1, h2, h3, h4, h5, h6, header, hr,
-html, legend, listing, menu, nav, ol, p, plaintext, pre, rp, section,
-ul, xmp { display: block; }
+div, dl, dt, figure, footer, form, h1, h2, h3, h4, h5, h6, header,
+hgroup, hr, html, legend, listing, menu, nav, ol, p, plaintext, pre,
+rp, section, ul, xmp { display: block; }
table { display: table; }
caption { display: table-caption; }
More information about the Commit-Watchers
mailing list