comments on the polyglot spec

Hi there,

Here are a few comments on "HTML/XHTML Compatibility Authoring
Guidelines" [1].

*  I am extremely circumspect about section 2 forbidding the use
    of processing instructions in a polyglot document. Polyglot
    documents served through a PHP processor use processing
    instructions and will then be not editable by editing
    environments following the guidelines...

*  section 1 implies a polyglot document cannot be a frameset???

*  typo in 1st sentence of 5.1.1, "pasrsers" instead of "parsers"

*  first sentence of section 5.2 mentions CSS but none of the prose
    in that section applies to CSS ; CSS is not a normative reference.

*  in section 5.2.3, I have no idea what is an "Attribute character".
    This is undefined in normative references to the document or anywhere
    else in the spec.

    similarly, I have no idea what is an "attribute letter" because
    this is undefined in normative references or anywhere else in the
    spec.

*  in section 5.3, first code example in parenthesis is not an
    empty paragraph, it contains a text node with one whitespace...

* I recommend mentioning in section 8 that linking to an external
    stylesheet using the xml-stylesheet PI is not allowed as per
    section 2.

[1] 
http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html

</Daniel>

Received on Tuesday, 18 May 2010 21:23:46 UTC