Page MenuHomePhabricator

Better Diffs: Accessibility Considerations
Closed, DeclinedPublic

Description

This is currently a research ticket which should allow us to further narrow down specifications for this task. This could include asking around in Accessibility Slack channel.

Use cases

  • As a screen reader user of the diff, I want to see screen reader support designed into this feature rather than considered as an afterthought.
  • As a screen reader user of the diff, I am able to access accurate and helpful descriptions about the changes of the deletion and addition columns, as well as the visual descriptors of what changed
  • As a volunteer technical contributor, I want to read thorough documentation about the diff, so that I can understand how to contribute to the project

Details for QA

  • Test with screen reader

Impact

  • Make a more accessible better diffs.

Contact Person / Team

  • Community Tech

Event Timeline

Hello @Graham87, we are starting work around improving wikidiff2 and we are starting the conversations around accessibility in better diffs. Do you have any feedback regarding accessibility improvements and screen reading users when using better diffs? Thank you.

At the moment I mostly check diffs by going in to the HTML source and searching for "diffch" ... which I've been doing for many years now. I'm generally alright with that, but of course it does fail horribly when line breaks are removed, etc. Recently more screen readers have better support for deletion/insertion annotation; when it comes to Windows screen readers, both JAWS and NVDA support reading them while NVDA supports moving between annotations. It could be nice to have some mode (enabled/disabled on the fly) that *only* shows the text that's changed and not the surrounding text.

NRodriguez updated the task description. (Show Details)
NRodriguez updated the task description. (Show Details)

Notes

  • We should attempt to use ARIA annotations where appropriate to provide hints to screen readers
    • role="insertion" (W3C) and role="deletion" (W3C) — semantically denote HTML elements whose contents represent an insertion to or deletion from the overall document.

Notes

  • We should attempt to use ARIA annotations where appropriate to provide hints to screen readers
    • role="insertion" (W3C) and role="deletion" (W3C) — semantically denote HTML elements whose contents represent an insertion to or deletion from the overall document.

ARIA roles are necessary only when the semantic of the element with the role differs from the role assigned e.g. <div role="insertion"> is a change in semantic from "none" to "insertion", versus <ins>, which already carries the "insertion" semantic.