Skip to content

fix: Clarify 'No missing headings' summary text - #7811

Open
Modusensus (modusensus) wants to merge 1 commit into
microsoft:mainfrom
modusensus:fix/update-no-missing-headings-summary
Open

Modusensus (modusensus) wants to merge 1 commit into
microsoft:mainfrom
modusensus:fix/update-no-missing-headings-summary

Conversation

@modusensus

Copy link
Copy Markdown

Details

Clarifies the summary text for the "No missing headings" requirement (#7762). The previous wording ("Text that looks like a heading must be coded as a heading") can be confusing or misleading, since it can feed into the common misconception that headings should be used to format text. The new wording describes headings by their function instead of their appearance.

New wording:

Text that labels a section of the page must be coded as a heading.

This change touches:

  • The requirement description in the headings assessment test step
  • The "How to test" instructions for the same test step
  • The associated guidance content page
  • Test snapshots that mirror the updated text

Motivation

Addresses #7762

Pull request checklist

  • Addresses an existing issue: Consider adjusting summary text for "5.2 No missing headings" #7762
  • Ran yarn fastpass
  • Added/updated relevant unit test(s) (and ran yarn test)
  • Verified code coverage for the changes made
  • PR title AND final merge commit title both start with a semantic tag (fix:, chore:, feat(feature-name):, refactor:). See CONTRIBUTING.md.
  • (UI changes only) Added screenshots/GIFs to description above
  • (UI changes only) Verified usability with NVDA/JAWS

Update the requirement description, how-to-test instructions, and associated guidance content to describe headings by their function (labels a section of the page) rather than their appearance, reducing false positives and avoiding the common misconception that headings should be used for text formatting. Sync affected test snapshots.

Addresses microsoft#7762
@modusensus
Modusensus (modusensus) requested a review from a team as a code owner September 9, 2026 21:17
@modusensus

Copy link
Copy Markdown
Author

@microsoft-github-policy-service agree

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