3.2. Common microsyntaxes

3.2. Common microsyntaxes
http://dev.w3.org/html5/spec/Overview.html#common1

This was an interesting read. Very complex, obviously not aimed at
authors (particularly the common parser idioms bit, which is
unfortunately the very first bit one reads).

I'd like to propose this section be moved to section 8. The HTML
syntax. I think it fits better there.

I ignored most of the detail aimed at implementors, and it mostly made
sense. I have some comments for consideration (but these are all
relatively minor).

3.2.2. Boolean values
http://dev.w3.org/html5/spec/Overview.html#boolean
boolean attributes would benefit from a simple example, particularly
showing that the values must be lowercase: e.g. selected OR
selected="selected" NOT selected="Selected" (value must be lowercase).

3.2.3.4. Ratios
http://dev.w3.org/html5/spec/Overview.html#ratios
Bit surprised by all the supported denominators and slightly concerned
that we might see inconsistent implementation. However, if they are
supported that will be excellent, particularly for use inside <meter>
elements (allowing authors to use the denominator of choice rather
than specify everything %).

3.2.4.1. Specific moments in time
http://dev.w3.org/html5/spec/Overview.html#specific
Wondering about the examples here. Why not stick to W3CDTF for the
examples? It's good that the parsing instructions are flexible but I'd
rather keep examples simple and consistent.
W3CDTF: http://www.w3.org/TR/NOTE-datetime

As you can tell, these comments are all minor. I'm happy with this
section, although finding it very complex (particularly for authors).

Received on Sunday, 29 July 2007 10:31:19 UTC