[xhtml-role] Abstract/Introduction - Hints about the technology

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 ***

Received on Thursday, 10 August 2006 07:38:18 UTC