Assistive technology announcements

Overview

These guidelines will help you determine when assistive tools should output a message.

Guidelines

• Always: Announce location changes — Help users understand where they are on a page. Maintain positional awareness.
• Always: Announce results of user actions — Give feedback about the success or failure directly following a user action.
• Sometimes: Announce other changes — Explore case-by-case when changes are disconnected from the user’s place and the success or failure of the user’s actions. For example:
  • Distracting change announcements: When other users add issue comments; when presence indicators appear
  • Essential change announcements: When log lines stream in on the GitHub Actions workflow run page

Additional resources

• Deep Dive: Page and Navigation transitions, Dynamic Content, and SPAs (only accessible to GitHub staff)
• Deep Dive: Save Patterns & Status Messages (only accessible to GitHub staff)

Edit this page on GitHub

1 contributor

Last edited by emilybrick on January 26, 2023