This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 13475 - Remove wrong example
Summary: Remove wrong example
Status: RESOLVED WONTFIX
Alias: None
Product: HTML WG
Classification: Unclassified
Component: LC1 HTML5 spec (show other bugs)
Version: unspecified
Hardware: PC Windows NT
: P2 normal
Target Milestone: ---
Assignee: Ian 'Hixie' Hickson
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-07-30 20:06 UTC by Jirka Kosek
Modified: 2011-08-04 05:14 UTC (History)
4 users (show)

See Also:


Attachments

Description Jirka Kosek 2011-07-30 20:06:27 UTC
In section 3.2.1 Semantics there is example showing necessity of using <hgroup> in situations where <h2> contains subheading. This example is simply misleading because in history <h2> was used for subheadings of headings expressed by <h1>. This misleading example should be removed even if the <hgroup> will remain in the spec after LC.
Comment 1 Aryeh Gregor 2011-08-02 16:00:31 UTC
EDITOR'S RESPONSE: This is an Editor's Response to your comment. If you are
satisfied with this response, please change the state of this bug to CLOSED. If
you have additional information and would like the Editor to reconsider, please
reopen this bug. If you would like to escalate the issue to the full HTML
Working Group, please add the TrackerRequest keyword to this bug, and suggest
title and text for the Tracker Issue; or you may create a Tracker Issue
yourself, if you are able to do so. For more details, see this document:

   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: Rejected
Change Description: no spec change
Rationale:

The example is correct.  In the current HTML spec, any tag that's heading content starts a new section:

"""
The first element of heading content in an element of sectioning content represents the heading for that section. Subsequent headings of equal or higher rank start new (implied) sections, headings of lower rank start implied subsections that are part of the previous one. In both cases, the element represents the heading of the implied section.
"""
http://www.whatwg.org/specs/web-apps/current-work/multipage/sections.html#headings-and-sections

Thus <h1>foo</h1><h2>bar</h2> marks up a rank-one section whose contents begin with a rank-two subsection.  <hgroup><h1>foo</h1><h2>bar</h2></hgroup> marks up the start of a rank-one section with no subsection (at least, it doesn't start with one).  An example of a case where <h1>foo</h1><h2>bar</h2> would be correct is something like <http://en.wikipedia.org/w/index.php?title=Egyptian_temple&oldid=442681377>, which has

  <h2>Functions</h2>
  <h3>Religious</h3> ...
  <h3>Economic and administrative</h3> ...

In this case, the lack of an <hgroup> indicates that the entire contents of the "Functions" section consists of two subsections, "Religious" and "Economic and administrative".

The example obviously will have to be fixed if <hgroup> is removed, but for now it's correct.
Comment 2 Michael[tm] Smith 2011-08-04 05:14:28 UTC
mass-move component to LC1