HTML/XHTML Compatibility Authoring Guidelines to FPWG

 
This document will be moving to FPWD.  We should review it.  It looks like a rough first draft.

Here are some issues I note right off, mostly of style and scope, without reference to accuracy of the intended content.

- It immplies that validation and parsing are the same;.  It's crucial in a document mennt to provide authoring guidelines to make clear the difference between well-formed XML, XML valid according to some type of schema, and HTML5-compliant tagsoup parsing. Otherwise authors have no principles to fall back on to undertstand what's going wrong when things fail.

- The abstract claims that it summarizes guidelines for authors, and lists the various things which it does not define, yet it later has Normative and non-Normative sections.  If it has Normative definitions, it needs to state the scope for which it is the normative definition, and provide a conformance section.  Likely this document is in fact a set of guidelines that have no conformance, no scope of authoritative definition, and hence will have no normative sections.

- MAY is highted as rfc2119 in section 3, yet section 3 is non-normative. This pattern is repeated throughout.

Leigh.


-----Original Message-----
From: chairs-request@w3.org [mailto:chairs-request@w3.org] On Behalf Of Sam Ruby
Sent: Wednesday, June 02, 2010 9:53 AM
To: Philippe Le Hegaret
Cc: w3c Team Archive; chairs@w3.org; Eliot Graff
Subject: Transition Request: HTML/XHTML Compatibility Authoring Guidelines to FPWG

The HTML Working Group requests transition of the HTML/XHTML Compatibility Authoring Guidelines Editor's Draft to a First Public Working Draft.

Document Title: HTML/XHTML Compatibility Authoring Guidelines
URI: 
http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html
Estimated Publication Date: June 9th
Abstract and Status sections can be found in the URI above.

We request approval of a new document title and shortname.

Evidence of Group Decision:
   http://lists.w3.org/Archives/Public/public-html/2010Jun/0028.html
   http://lists.w3.org/Archives/Public/public-html/2010May/0297.html

- Sam Ruby

Received on Thursday, 3 June 2010 17:04:53 UTC