W3C home > Mailing lists > Public > public-html@w3.org > July 2012

Review of ISSUE-164 change proposals - Part 3: Replace hgroup with a simple element

From: Paul Cotton <Paul.Cotton@microsoft.com>
Date: Tue, 24 Jul 2012 23:06:11 +0000
To: Kornel Lesiński <kornel@geekhood.net>
CC: "public-html@w3.org" <public-html@w3.org>
Message-ID: <AB5704B0EEC35B4691114DC04366B37FC060BD@TK5EX14MBXC289.redmond.corp.microsoft.com>
We have five change proposals for ISSUE-164:
http://dev.w3.org/html5/status/issue-status.html#ISSUE-164

The following is a Chairs review of the following change proposal:

Replace hgroup with a simple element
http://www.w3.org/html/wg/wiki/ChangeProposals/hSub

1. Structure of change proposal

The proposal includes an appropriate Summary (actually entitled "Change Proposal"), Rationale,  Details and Impact (only Risk are provided).

2. General comments on change proposal

a) Rationale

> Existing content<http://wiki.whatwg.org/wiki/Hgroup_element#Real_World_Examples> on the web does not use as complex multi-level subheadings as <hgroup> was intended to support.

This argument would be stronger if you explicitly called out the <hgroup> examples in the use cases and show that they do not "use a complex multi-level subheadings".

Several other Change Proposals make assertions about the implementation experience of <hgroup>.  Your Rationale would be stronger if you mentioned this item to give your position relative to the implementation experience of <hgroup>.

b) Details

It would be much better if the supplied Details section was written more in the style of a replacement for Section 4.4.7 "The hgroup element" [1].   It may not be obvious to the CP reader or to the Editor if you have given all the material needed for the new element you are proposing.

In addition, these Details are possibly inadequate.  If these instructions imply that just Section 4.4.7 "The hgroup element" should be replaced then they omit the other mentions to <hgroup> in the HTML5 specification.  In addition the detail to add the proposed <hsub> element omits any indication if <hsub> should be added to any other sections in the document to replace the <hgroup> occurrences.

Styling and Authoring Errors

These two parts of the Details do not appear in Section 4.4.7 "The hgroup element".  If you draft an actual <hsub> section to replace Section 4.4.7 "The hgroup element" then you may way to move these two sub-sections to either your Rationale section or to the Details and Impact section.

Please let the Chairs know by Tue Jul 31 if you plan to revise your change proposal and when you can do the revision by.

/paulc
HTML WG co-chair

[1] http://dev.w3.org/html5/spec/single-page.html#the-hgroup-element

Paul Cotton, Microsoft Canada
17 Eleanor Drive, Ottawa, Ontario K2E 6A3
Tel: (425) 705-9596 Fax: (425) 936-7329
Received on Tuesday, 24 July 2012 23:06:44 UTC

This archive was generated by hypermail 2.3.1 : Monday, 29 September 2014 09:39:33 UTC