[DOCS] Screen reader accessibility docs still say permission mode changes are not announced
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/accessibility
Section/Topic
The Known limitations section's description of permission mode changes in screen reader mode. The permission-mode cycling guidance in the permission modes and interactive mode references should also be kept consistent.
Current Documentation
The accessibility page currently lists this as a limitation:
Some behaviors aren't adapted for screen reader mode: * Mode changes, such as entering plan mode, aren't announced yet.
The same page describes permission prompts as accessible numbered menus, but does not describe any spoken feedback when the user cycles modes. The permission modes page only says:
During a session: pressShift+Tabto cycledefault→acceptEdits→plan. The current mode appears in the status bar.
What's Wrong or Missing?
Claude Code v2.1.210 now announces permission mode changes aloud in screen reader mode when the user cycles modes with Shift+Tab. The accessibility page still says that mode changes are not announced, so it contradicts the current behavior and tells screen-reader users that an important accessibility feature is unavailable.
The cycling instructions also describe the visual status-bar indicator without explaining the spoken mode-change feedback. A screen-reader user can therefore miss that the active permission mode changed or continue relying on the outdated limitation.
Suggested Improvement
Remove or replace the outdated limitation in the Known limitations section. Add a versioned note stating that, as of Claude Code v2.1.210, screen reader mode announces the selected permission mode when Shift+Tab cycles through modes. Clarify that the announcement applies to interactive CLI mode switching.
Update the permission modes and interactive mode references to cross-link the accessibility guidance and mention that screen reader users hear the mode change while cycling, in addition to seeing the mode in the status bar when visual rendering is available.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/accessibility | Known limitation incorrectly says permission mode changes are not announced |
| https://code.claude.com/docs/en/permission-modes | CLI Shift+Tab mode-cycle instructions describe only the visual status bar |
| https://code.claude.com/docs/en/interactive-mode | Keyboard shortcut reference says Shift+Tab cycles modes without accessibility-specific feedback |
Total scope: 3 pages affected by the same outdated or incomplete description of screen-reader feedback for permission-mode cycling.
The behavior change was introduced in Claude Code v2.1.210.