This task involves the work of introducing a new edit suggestion within the VisualEditor Suggestion Mode that makes people aware when heading levels that do not follow semantic order.
Meta
- Relevant Wish, Policy, Guideline, Project, etc.: en:WP:MOS/Accessibility#Headings
- Suggestion scope: All Wikipedias
Story
As someone curious to know if there are straightforward and intuitive ways that I might be able to improve the Wikipedia article I was just reading, I'd value knowing if there are any section headings that are out of semantic order, so that I can make the article easier to navigate, especially for people using assistive technologies (like screen readers).
Requirements
- Card design [i]
- Title: Heading level
- Description: Help make this page easier for people to navigate and read by adjusting this heading level. Learn more
- Note: the Learn more link ought to be configurable on a per project basis.
- Calls to action:
- Fix heading: When tapped, automatically adjust the heading in question such that it appears in semantic order
- Dismiss: When tapped, leave the headings in question unchanged
- Success state
- Regardless of what action someone selects, show a toast that reads: Thank you for making it easier for people to navigate and read this page.
- Detection
- Present this suggestion when a heading level descends by > 1
i. Please consider this initial card design as preliminary. We will refine the experience together once we have a prototype in-hand.



