[Bug 22978] New: [AAPI]: Update Sections 1 and 2

https://www.w3.org/Bugs/Public/show_bug.cgi?id=22978

            Bug ID: 22978
           Summary: [AAPI]: Update Sections 1 and 2
    Classification: Unclassified
           Product: HTML WG
           Version: unspecified
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: HTML a11y APIs (editor: Steve Faulkner, Cynthia
                    Shelly)
          Assignee: faulkner.steve@gmail.com
          Reporter: jason@accesscult.org
        QA Contact: sideshowbarker+html-a11y-api@gmail.com
                CC: mike@w3.org, public-html-admin@w3.org,
                    public-html-bugzilla@w3.org,
                    public-html-wg-issue-tracking@w3.org

The Introduction and the section on Exposing HTML features that do not directly
map to accessibility API properties should be updated. I suggest that at least
the following changes be made:

1. Introduce the APIs in a way that matches how they are are presented in the
mapping tables, e.g., explain UIAExpress, and why MSAA+UIAExpress and MSAA+IA2
are columns to themselves. 

2. Explain what an "accessible" is.

3. Update the use of <header> as the example in Section 2. A few of the APIs
now assign specific roles for this element.

There's undoubtedly more that could be done to improve these sections.

-- 
You are receiving this mail because:
You are on the CC list for the bug.

Received on Thursday, 15 August 2013 20:59:22 UTC