Attention ARIA Authoring Practices taskforce -- major revisions to review

Of course, feedback from anyone is welcome, but I would particularly like 
feedback from APG TF participants.
Please pay close attention the button and checkbox sections in particular.

The master branch with all the changes at:
https://rawgit.com/w3c/aria/master/practices/aria-practices.html 

The recent commit log of changes follows.
commit 88b3780938e541c4457f15153a7bb5f8e06f9605
Author: mcking65 <mattking@us.ibm.com>
Date:   Wed Apr 29 05:06:30 2015 -0700

    modified:   aria-practices.html
    Resolved Bug 27400 – pattern-checkbox Add text about labelling.
    Resolved Bug 27398 – pattern-checkbox Remove text about using images 
for the state.
    Proposed resolution to Bug 27278 – pattern-checkbox Separate checkbox 
into dual-state and tri-state checkbox examples.
    Instead of separating, I attempted to reduce confusion and provide 
desired clarity  with major re-write and simplification of Description, 
Keyboard Interaction, and WAI-ARIA Roles, States, and Properties.
    Made other editorial changes to checkbox language, e.g., remove 
"should" and replace with present tense language, remove excess role and 
state information from description and replace with reader-friendly 
descriptive language.

commit 5f4a9fc496a9f99934676931be6694399c21be70
Author: mcking65 <mattking@us.ibm.com>
Date:   Wed Apr 29 02:32:48 2015 -0700

    modified:   aria-practices.html
    Drafted proposed resolution to Bug 27329 – pattern-button Clean up 
language in the Keyboard section.

commit a6f58ae4acb5a03e7e8f9d303d5f76353d4ca334
Author: mcking65 <mattking@us.ibm.com>
Date:   Wed Apr 29 01:38:43 2015 -0700

    modified:   aria-practices.html
    Minor update to editor's note in Alert Dialog or Message Dialog 
section to indicate that minor edits have been made but a complete review 
is pending.

commit 7a3eb5d28d6da5e956e85c6be40285922ebd4d97
Author: mcking65 <mattking@us.ibm.com>
Date:   Wed Apr 29 01:28:47 2015 -0700

    modified:   aria-practices.html
    Resolved Bug 28572 – Pattern - Alert or Message Dialog: visible focus 
indicator is required.
    Changed text to read:
    When the message area of a dialog is focusable and has focus, a visual 
focus indicator is required, and it is recommended that the indicator 
encompass the complete message.

commit a4f56e9f35bf4c92ac6070716b2331d5faa4e5cd
Author: mcking65 <mattking@us.ibm.com>
Date:   Wed Apr 29 01:06:05 2015 -0700

    Modified:   aria-practices.html
    Rewrote description of button pattern to close bugs 27327 and 27328.

commit 59b5cdeeb0285a49aa8b39e382550fdfe1470718
Author: mcking65 <mattking@us.ibm.com>
Date:   Tue Apr 28 21:59:37 2015 -0700

    modified:   aria-practices.html
    Added following note to section 2.2 Accordion
    Editor's note: This section has not been updated since it was 
integrated from APG version 1.0 -- an APG taskforce review is pending.

commit fd87c8aa36fb1e2e2b5abbc2cb629f2148b42032
Author: mcking65 <mattking@us.ibm.com>
Date:   Tue Apr 28 19:33:23 2015 -0700

    modified:   aria-practices.html
    Added following note to sections that have not been reviewed and are 
not being updated:
    Editor's note: This section has not been updated since it was 
integrated from APG version 1.0 -- an APG taskforce review is pending.
    Added following note to sections in the appendix that are from the 
ARIA primer.
    Editor's note: This section has not been updated since it was 
integrated from the ARIA 1.0 Primer -- an APG taskforce review is pending.

commit c649b5082bd326fb84197b91a16cf2a4f1a9db2d
Author: mcking65 <mattking@us.ibm.com>
Date:   Tue Apr 28 18:59:45 2015 -0700

    modified:   aria-practices.html
    Edits to alert section, including:
    -  addition of screen reader guidance regarding dynamically rendered 
alerts vs alerts present before page load completes
    - Changed effect to affect
    - Change keyboard shortcuts to keyboard interaction
    Also changed subsequent H3 for "Alert or message dialog" to "Alert 
dialog or Message Dialog"

commit 18cd4bf2679c7f3ecb6a2c3acef21dc3076f43f7
Author: jnurthen <james@nurthen.com>
Date:   Mon Apr 27 10:45:27 2015 -0700

    Primer move (continued)

commit 620ef2a1640abe141380ccb93de6ce2d342fcbbd
Author: jnurthen <james@nurthen.com>
Date:   Mon Apr 27 10:33:54 2015 -0700

    Move of Primer stuff to appendix

commit 63d99fdfc590d237c8b1e38f36ff7261e6cf9e91
Author: jnurthen <james@nurthen.com>
Date:   Mon Apr 27 10:21:43 2015 -0700

    Modified Title of Section 2

commit 04b393749ad1452bfdefba787c466bdc60f52168
Author: mcking65 <mattking@us.ibm.com>
Date:   Mon Apr 27 09:51:42 2015 -0700

    modified:   practices/aria-practices.html
    Created alert role reference in alert design pattern section.

commit 425f439a402fe7f512557db083ef2949db1a6034
Author: mcking65 <mattking@us.ibm.com>
Date:   Mon Apr 27 09:14:50 2015 -0700

    modified:   practices/aria-practices.html
    Provided proposed solution to Bug 28037: pattern-alert Need to develop 
a proposal for a description

commit 1b4f0415721407790d15a18a40ca66a5109a4c5e
Author: mcking65 <mattking@us.ibm.com>
Date:   Sat Apr 25 11:45:03 2015 -0700

    modified:   aria-practices.html
    Changes to global recommendations section 2.1 discussed in April 20 
meeting:
    Changed title to remove word global and specify content is focused on 
keyboard.
    Editorial changes to list of keyboard commands to make wording 
consistent and more concise.
    Moved "Widgets withinWidgets to end and added editorial note about 
moving it in the future.
    Simplified wording of the the widgets within widgets  example.


Matt King
IBM Senior Technical Staff Member
I/T Chief Accessibility Strategist
IBM BT/CIO - Global Workforce and Web Process Enablement 
Phone: (503) 578-2329, Tie line: 731-7398
mattking@us.ibm.com

Received on Wednesday, 29 April 2015 12:24:46 UTC