A designer's guide to documenting accessibility and user interactions (2022) (opens in new tab)

(stephaniewalter.design)

92 pointsgigglesupstairs1y ago6 comments

6 comments

Something I'd love to see more of is documentation that includes video or audio recordings of a screen reader being used with the site or components.

I'd find it so much easier to trust claims that something had been built with screen readers in mind if those claims were accompanied by video evidence of the core flows working with those tools!

ivankolev1y ago

You might be interested in guidepup then! I am in the process of integrating it into our playwright tests. Not affiliated, just a user: https://github.com/guidepup/guidepup

simonw1y ago

That looks great! I like that it covers both NVDA and VoiceOver.

I couldn't find any video or audio examples on the site, but it's possible I didn't look hard enough.

corps_and_code1y ago

Agreed, I would love that. With how varied screen readers can act between systems and web browsers I would like to have more "good" examples of what screen reader users would expect to encounter and consider a good experience.

devinprater1y ago

Yes, that actually would be helpful. It'd also be a kind of guide for people like me who use screen readers, to show how we're supposed to find things that are supposed to be important on the app.

rkhassen91y ago

Really nice UI conversation here. Well presented, easy to digest.

j / k navigate · click thread line to collapse

6 comments

simonw1y ago

Something I'd love to see more of is documentation that includes video or audio recordings of a screen reader being used with the site or components.

I'd find it so much easier to trust claims that something had been built with screen readers in mind if those claims were accompanied by video evidence of the core flows working with those tools!

ivankolev1y ago

You might be interested in guidepup then! I am in the process of integrating it into our playwright tests. Not affiliated, just a user: https://github.com/guidepup/guidepup

simonw1y ago

That looks great! I like that it covers both NVDA and VoiceOver.

I couldn't find any video or audio examples on the site, but it's possible I didn't look hard enough.

corps_and_code1y ago

devinprater1y ago

Yes, that actually would be helpful. It'd also be a kind of guide for people like me who use screen readers, to show how we're supposed to find things that are supposed to be important on the app.

rkhassen91y ago

Really nice UI conversation here. Well presented, easy to digest.

j / k navigate · click thread line to collapse