[Bug 13038] New: Still a silly lang attribute, and inconsistencies in the HTML5 Edition for Web Authors

http://www.w3.org/Bugs/Public/show_bug.cgi?id=13038

           Summary: Still a silly lang attribute, and inconsistencies in
                    the HTML5 Edition  for Web Authors
           Product: HTML WG
           Version: unspecified
          Platform: Other
               URL: http://www.w3.org/mid/4E03F18F.5020907@burningbird.net
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P3
         Component: HTML5 spec (editor: Ian Hickson)
        AssignedTo: ian@hixie.ch
        ReportedBy: mike+html-wg-mailbot@w3.org
         QAContact: public-html-bugzilla@w3.org
                CC: mike@w3.org, public-html-wg-issue-tracking@w3.org,
                    public-html@w3.org


public-html-comments posting from: Shelley Powers <shelleyp@burningbird.net>
http://www.w3.org/mid/4E03F18F.5020907@burningbird.net

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

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.

Received on Friday, 24 June 2011 04:27:21 UTC