Skip to content

Revise accessibility instructions for clarity and detail#678

Open
mfairchild365 wants to merge 2 commits intogithub:mainfrom
mfairchild365:patch-1
Open

Revise accessibility instructions for clarity and detail#678
mfairchild365 wants to merge 2 commits intogithub:mainfrom
mfairchild365:patch-1

Conversation

@mfairchild365
Copy link
Contributor

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

  • I have read and followed the CONTRIBUTING.md guidelines.
  • My contribution adds a new instruction, prompt, agent, or skill file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, or skill with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.

Description


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New collection file.
  • New skill file.
  • Update to existing instruction, prompt, agent, collection or skill.
  • Other (please specify):

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.

Updated accessibility instructions to improve clarity and specificity regarding coding practices for accessibility, including keyboard navigation and semantic structure.
Copilot AI review requested due to automatic review settings February 6, 2026 20:45
Copy link
Contributor

Copilot AI left a 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>
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.

1 participant