HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/3043

File a bug

SVNBugCommentTime (UTC)
3043Attempt to resolve the terminology confusion of heading vs header.2009-04-30 19:04
Index: source
===================================================================
--- source	(revision 3042)
+++ source	(revision 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>&lt;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>  &lt;title>Introduction to The Mating Rituals of Bees&lt;/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>  &lt;title>Dances used during bee mating rituals&lt;/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>&ndash;<code>h6</code> elements when the header has
+  heading of a section. The element is used to group a set of
+  <code>h1</code>&ndash;<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>&lt;hgroup&gt;
@@ -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>&ndash;<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 @@
 &lt;/header&gt;</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>&lt;header&gt;
  &lt;hgroup&gt;
@@ -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>&lt;h1><strong>&lt;img src="earthdayheader.png" alt="Earth Day"></strong>&lt;/h1></pre>
+   <pre>&lt;h1><strong>&lt;img src="earthdayheading.png" alt="Earth Day"></strong>&lt;/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; }

|