Hi,
This is a QA Review comment for "XHTML Role Attribute Module"
http://www.w3.org/TR/2006/WD-xhtml-role-20060725/
2006-07-25
1st WD

About http://www.w3.org/TR/2006/WD-xhtml-role-20060725/#anchor

The subtitle of the specification is more explicit/helpful than the abstract 
and the introduction.
                "A module to support role classification of elements"

Both the abstract
http://www.w3.org/TR/2006/WD-xhtml-role-20060725/#s_intro

        "The XHTML Role Attribute defined in this specification 
        provides XML languages with the ability integrate a "role" 
        attribute into any markup language based upon [XHTMLMOD]."

And the introduction 
http://www.w3.org/TR/2006/WD-xhtml-role-20060725/#abstract

        "This document is the first of a series of XHTML modules 
        designed to be used to help extend the scope of 
        XHTML-family markup languages into new environments. 
        It has been developed in conjunction with the accessibility 
        community and other groups to make it easier to describe 
        the semantic meaning of XHTML-family document content.

        Note that this work was originally done as part of the 
        [XHTML2] activity. It is being released in a separate, 
        stand-alone module in order to speed its adoption and 
        ease the migration to XHTML 2 when that is released."

doesn't give any clue what role attribute is about.

Please, give information about role attribute only.
        What is it for? It is written "provides XML languages with the ability 
integrate a "role"" What is the role of role?
        Where should it be used?
        Remove reference to the "first of a series of XHTML Modules", it's not 
strictly related to the technology described by itself and it's factual. You 
can put this information in the status. If you really think that it's 
important, create a note or a Web page defining this framework made of modules 
and points to it, a detailed roadmap.




-- 
Karl Dubost - http://www.w3.org/People/karl/
W3C Conformance Manager, QA Activity Lead
   QA Weblog - http://www.w3.org/QA/
      *** Be Strict To Be Cool ***

Reply via email to