Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 18, 2025

This PR adds a comprehensive list of popular accessibility software tools to the accessibility guidelines page to help developers test their docassemble interviews for accessibility compliance.

Changes Made

Added a new "Accessibility testing tools" section to docs/coding_style/accessibility.md that includes:

Screen readers

  • Free options: NVDA, VoiceOver, Orca, ChromeVox
  • Commercial options: JAWS, Dragon NaturallySpeaking

Browser accessibility checkers

  • WAVE Web Accessibility Evaluator, axe DevTools, Lighthouse, Accessibility Insights

Manual testing tools

  • Colour Contrast Analyser, accessibility bookmarklets, Web Accessibility Toolbar

Mobile accessibility testing

  • TalkBack (Android), Switch Access (Android), Voice Control (iOS)

Automated testing integration

  • ALKiln (Assembly Line's framework), Pa11y, aXe-core

Implementation Details

The new section is strategically placed after the introduction but before the specific accessibility guidelines. Each tool includes a direct link and brief description of its purpose. The section integrates seamlessly with the existing table of contents and maintains consistency with the documentation's style and structure.

This enhancement provides developers with practical resources for testing interview accessibility, with special emphasis on screen readers as requested in the original issue.

Fixes #429.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…y guidelines

Co-authored-by: nonprofittechy <7645641+nonprofittechy@users.noreply.github.com>
Copilot AI changed the title [WIP] Add a list of popular accessibility software tools? Add comprehensive accessibility testing tools section to accessibility guidelines Sep 18, 2025
Copy link
Member

@nonprofittechy nonprofittechy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the links and these seem both accurate and very helpful. This is good compilation of resources.

@nonprofittechy nonprofittechy marked this pull request as ready for review September 18, 2025 19:02
@nonprofittechy nonprofittechy merged commit f221a96 into main Sep 18, 2025
3 checks passed
@nonprofittechy nonprofittechy deleted the copilot/fix-429 branch September 18, 2025 19:02
Copy link
Contributor

@BryceStevenWilley BryceStevenWilley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Going to make a follow up PR to fix some of these comments. In general I think that fewer tools with a bit more context on how to use them when testing interviews is better than a dozen tools, where ~1/2 don't really apply, but I'll keep things mostly the same.


* **[TalkBack](https://support.google.com/accessibility/android/answer/6283677)** - Android's built-in screen reader.
* **[Switch Access](https://support.google.com/accessibility/android/answer/6122836)** - Android feature for users with motor disabilities.
* **[Voice Control](https://support.apple.com/en-us/HT210417)** - iOS voice navigation feature.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same with Dragon, I don't think that Voice Control is going to really help people with testing accessibility: if it gets picked up with Voice Over, it'll work with Voice Control. I'd probably link Voice Over down here again, just to emphasize that it's the same tool, both on Macs and iPhones.

BryceStevenWilley added a commit that referenced this pull request Sep 19, 2025
Address late comments in #562.

* Moves to the bottom of the page, to emphasize the other accessibility concerns over specific custom tools and screen readers.
* Removes voice command technology, which is less helpful for testing.
* Adds some clarifications on how to best use screen readers
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a list of popular accessibility software tools?

3 participants