Skip to content

Conversation

jnurthen
Copy link
Member

@jnurthen jnurthen commented Aug 6, 2025

Closes HTML-AAM #590

  1. Clarified passive voice statements - Converted statements like "MUST be exposed" to "User agents MUST expose" to explicitly identify the responsible party
  2. Standardized normative language - Updated lowercase "should" and "may" to RFC 2119 compliant "SHOULD" and "MAY" for consistency
  3. Fixed subject ambiguity - Added explicit subjects to statements that previously used passive voice, such as:
  • "it MUST be exposed" → "User agents MUST expose"
  • "MAY be treated" → "user agent MAY treat"
  • "MAY be provided" → "Authors MAY provide"
  1. Improved clarity - Enhanced descriptions of accessibility tree inclusion for media elements by restructuring text into bulleted lists
  2. Corrected inconsistent terminology - Changed "browser" to "user agents" for consistency throughout the specification

Copy link

netlify bot commented Aug 6, 2025

Deploy Preview for wai-aria ready!

Name Link
🔨 Latest commit df7cd05
🔍 Latest deploy log https://app.netlify.com/projects/wai-aria/deploys/68b72254b5c2f40008596d84
😎 Deploy Preview https://deploy-preview-2590--wai-aria.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Contributor

@Copilot 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 fixes normative statements in the HTML-AAM specification by clarifying the subject of requirements and standardizing the use of RFC 2119 keywords (MUST, SHOULD, MAY).

  • Updated statements to explicitly specify "user agents" as the subject of requirements instead of using passive voice
  • Standardized capitalization of RFC 2119 keywords for normative statements
  • Improved clarity of technical requirements for accessibility API mappings

@jnurthen jnurthen added the editorial a change to an example, note, spelling, grammar, or is related to publishing or the repo label Aug 7, 2025
@spectranaut spectranaut merged commit db9cdbb into main Sep 2, 2025
6 checks passed
@github-project-automation github-project-automation bot moved this from Needs Review to Reviewed, need PR checklist item in ARIA Editorial (Spec Prose Updates) PR Tracking Sep 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editorial a change to an example, note, spelling, grammar, or is related to publishing or the repo spec:html-aam
Projects
Status: Reviewed, need PR checklist item
Development

Successfully merging this pull request may close these issues.

3 participants