w3c / aria-practices

WAI-ARIA Authoring Practices Guide (APG)
https://www.w3.org/wai/aria/apg/
Other
1.21k stars 336 forks source link

Draft appendix section describing screen reader reading modes #193

Open mcking65 opened 7 years ago

mcking65 commented 7 years ago

Draft content for the section in the appendix titled: "Understanding Screen Reader Document Reading and Application Reading Modes"

The placeholder is at: http://w3c.github.io/aria-practices/#ScreenReaderModes

carmacleod commented 7 years ago

I found this article by Leonie Watson helpful: http://tink.uk/understanding-screen-reader-interaction-modes/ Maybe she would be willing to help draft this appendix section?

I also found that the description of VoiceOver's non-modal approach in this article was helpful in explaining the modes in the Windows screen readers: http://webaim.org/blog/three-things-voiceover/

OlivierNourry commented 6 years ago

May I suggest this? https://disic.github.io/guide-lecteurs_ecran/ It's a document meant to help people who are new to screen readers and wish to use one to test interactive components. It's provided freely, under an open license, as a companion resource for the French official web accessibility guidelines. It describes how to configure JAWS, NVDA and VoiceOver to test, the different reading modes (https://disic.github.io/guide-lecteurs_ecran/restitution.html), and provides testing guidance for some ARIA based components, complete with examples of code and restitution. It's in French, but certainly worth the translation effort, IMHO.

mcking65 commented 6 years ago

@OlivierNourry, thanks for the suggestion. Unfortunately, I can't assess fit without a translation. It does sound larger and more detailed than what I envisioned as necessary for this section of the authoring practices though.

mcking65 commented 6 years ago

With commit 37ada7f, removed links to the placeholder for this section and removed the placeholder. Postponing this work to release 2.