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

Received on Friday, 23 November 2007 21:20:47 UTC