Re: Editorial comments for WAI-ARIA documents

Thank you Shawn.


Rich Schwerdtfeger
Distinguished Engineer, SWG Accessibility Architect/Strategist
Chair, IBM Accessibility Architecture Review  Board
blog: http://www.ibm.com/developerworks/blogs/page/schwer


                                                                           
             Shawn Henry                                                   
             <shawn@w3.org>                                                
                                                                        To 
             11/23/2007 03:21          Richard                             
             PM                        Schwerdtfeger/Austin/IBM@IBMUS,     
                                       Lisa Pappas <Lisa.Pappas@sas.com>   
                                                                        cc 
                                       wai-eo-editors                      
                                       <wai-eo-editors@w3.org>, Michael    
                                       Cooper <cooper@w3.org>, Al Gilman   
                                       <Alfred.S.Gilman@IEEE.org>          
                                                                   Subject 
                                       Editorial comments for WAI-ARIA     
                                       documents                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           




Rich & Lisa,

Here are a few suggestions from EOWG's brief review of
http://www.w3.org/WAI/PF/aria-practices/
I think all of these will apply to the revised documents that you are
working on.

* Use "WAI-ARIA" (as opposed to only "ARIA") in the title, the headings,
and the beginning of each section. See "Terminology and usage guidance ..."
under http://www.w3.org/WAI/EO/changelogs/cl-aria-docs#notes )
[http://www.w3.org/2007/11/05-eo-minutes.html#action16]

* In the beginning add a link to the Overview doc
http://www.w3.org/WAI/intro/aria.php
[http://www.w3.org/2007/11/05-eo-minutes.html#action19]

* Add [Contents] link at the top, e.g., http://www.w3.org/TR/WCAG20/
[http://www.w3.org/2007/11/05-eo-minutes.html#action14]

* Reconsider the heading levels -- the subheadings at a specific level
don't seem parallel. Consider making the TOC a tree control. :-) If not,
consider providing a short TOC that has only the top level (to provide an
overview of the content of the document), and then a detailed TOC -- or
maybe a single TOC that has only 2 levels.
[http://www.w3.org/2007/11/05-eo-minutes.html#action18]

* Provide the reference for the 55% stat and any others
[http://www.w3.org/2007/11/05-eo-minutes.html#action20]

All for now...

Best,
~Shawn