RE: Editorial comments for WAI-ARIA documents

Shawn,

Thank you for sending these.
I'll print them out for the editors F2F that begins tomorrow.

Cheers,

Lisa

Lisa Pappas
accessibility analyst
SAS Institute, Inc.
Cary, NC  USA
lisa.pappas@sas.com

-----Original Message-----
From: Shawn Henry [mailto:shawn@w3.org]
Sent: Friday, November 23, 2007 4:21 PM
To: schwer@us.ibm.com; Lisa Pappas
Cc: wai-eo-editors; Michael Cooper; Al Gilman
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

Received on Tuesday, 8 January 2008 21:39:50 UTC