Skip to content

Conversation

@digitarald
Copy link
Contributor

Adds .github/instructions/accessibility.instructions.md to guide AI agents on accessibility patterns in VS Code.

Content

  • Keybinding scoping with CONTEXT_ACCESSIBILITY_MODE_ENABLED
  • Accessible help dialogs using AccessibleContentProvider
  • Screen reader announcement patterns and double-speak prevention
  • Multi-modal notifications (audio signals, ARIA alerts, OS notifications)
  • Verbosity setting registration for new features

Reviewer

@meganrogge — Primary architect of VS Code's accessibility infrastructure (PR #212138 AccessibleViewRegistry, PR #221523 accessible view navigation)

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

This PR significantly streamlines accessibility instructions for AI coding agents by replacing verbose documentation with concise, code-focused patterns. The new format targets AI agents rather than human developers by emphasizing practical code examples over comprehensive explanations.

Changes:

  • Replaced 273-line comprehensive accessibility guide with 79-line focused instruction set
  • Consolidated detailed sections on accessibility help dialogs, accessible views, and verbosity settings into minimal code examples
  • Removed extensive documentation on keyboard navigation, ARIA labels, and accessibility signals in favor of essential patterns
  • Updated description metadata to clearly indicate AI-agent-specific scope

@meganrogge meganrogge merged commit 5dcb935 into main Feb 6, 2026
28 checks passed
@meganrogge meganrogge deleted the digitarald/instructions-accessibility branch February 6, 2026 16:05
daviddossett pushed a commit to daviddossett/vscode that referenced this pull request Feb 7, 2026
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.

2 participants