W3C home > Mailing lists > Public > wai-eo-editors@w3.org > January 2008

RE: Editorial comments for WAI-ARIA documents

From: Lisa Pappas <Lisa.Pappas@sas.com>
Date: Tue, 8 Jan 2008 16:39:36 -0500
To: Shawn Henry <shawn@w3.org>, "schwer@us.ibm.com" <schwer@us.ibm.com>
CC: wai-eo-editors <wai-eo-editors@w3.org>, Michael Cooper <cooper@w3.org>, Al Gilman <Alfred.S.Gilman@IEEE.org>
Message-ID: <345520A34347BA49B798F70B218ACD130437B89B45@MERCMBX14.na.sas.com>

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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 12 January 2010 00:13:15 GMT