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.htmlhttp://lists.w3.org/Archives/Public/public-html/2010May/0297.html
- Sam Ruby