W3C home > Mailing lists > Public > public-html-comments@w3.org > June 2011

Still a silly lang attribute, and inconsistencies in the HTML5 Edition for Web Authors

From: Shelley Powers <shelleyp@burningbird.net>
Date: Thu, 23 Jun 2011 21:08:15 -0500
Message-ID: <4E03F18F.5020907@burningbird.net>
To: public-html-comments@w3.org
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 
Received on Friday, 24 June 2011 02:08:42 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 24 June 2011 02:08:42 GMT