-
Notifications
You must be signed in to change notification settings - Fork 2.4k
Revise accessibility instructions for clarity and detail #678
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
Updated accessibility instructions to improve clarity and specificity regarding coding practices for accessibility, including keyboard navigation and semantic structure.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull request overview
Updates the existing accessibility instruction set (a11y.instructions.md) to be more structured and explicit about practical a11y implementation requirements (keyboard/focus, semantics, contrast, forced-colors, reflow), aiming to improve instruction clarity and effectiveness.
Changes:
- Reorganized the document into “MUST/SHOULD” sections with a final verification checklist.
- Added/expanded guidance for forced-colors/high-contrast mode, reflow at 320px, and token-based color usage.
- Simplified and consolidated prior detailed sections (keyboard, forms, tables/grids, graphics) into clearer rule sets.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
aaronpowell
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you merge with main and run npm run build to ensure the readme is correct
|
@aaronpowell done :) |
Updated accessibility instructions to improve clarity and specificity regarding coding practices for accessibility, including keyboard navigation and semantic structure.
I've benchmarked this new version against the old one across many LLMs and it is over 2x more effective.
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.Description
Type of Contribution
Additional Notes
By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.