Aside from the fact that the HTML5 Edition for Web Authors document
still has the silly lang attribute in the HTML source, there are other
problems with the document, notably an inconsistency of references.
If the purpose of the document is to provide a more web author centric
view of the HTML5 specification, without burying web authors in the
minutia of implementation details, the document only partially succeeds.
For instance, we can find a web author centric view of the
MediaController[1] . However, if you click on any of the methods,
properties, or events listed in the table describing the MediaController
interface, you're taken back to the main HTML5 specification--whereby
you're completely drowned in implementation detail.
Yet right underneath the table are web author friendly descriptions of
both the MediaController interface methods and properties. These are
what should be what's linked within the MediaController table. In
addition, the events also need a more web friendly view, as clicking on
each of these also returns the person to the full HTML5 spec.
Shelley Powers
[1]
http://www.w3.org/TR/2011/WD-html5-20110525/author/the-track-element.html#mediacontroller
- Still a silly lang attribute, and inconsistencies in the... Shelley Powers
-