You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[CI/a11y] Add automated heading-hierarchy / axe-core check to site_lint.yml #8610
Currently, accessibility regressions related to heading structure (such as skipping heading levels or incorrect hierarchy order) are not caught automatically by CI during PR checks.
Recently, a heading level skip issue was identified and resolved manually ([link to your PR here]). Integrating an automated accessibility auditor into our CI pipeline would prevent similar regressions from slipping through in the future.
Proposed Solution
Add an automated accessibility testing tool (such as axe-core, @axe-core/playwright, or an equivalent linting rule/script) to the site_lint.yml GitHub Actions workflow.
Ensure the check specifically validates heading-order hierarchy rules (e.g., preventing skips like H1 → H3).
Hi! I’m looking into this issue and have started working on a possible solution using Playwright + axe-core. Before I go further, I just wanted to clarify one thing: should the heading-order check cover all relevant React.dev pages, or is there a specific set of pages/routes you’d like it to run against?
Activity
TanyaMandloi05 commentedon Aug 25, 2026
Hi! I’m looking into this issue and have started working on a possible solution using Playwright + axe-core. Before I go further, I just wanted to clarify one thing: should the heading-order check cover all relevant React.dev pages, or is there a specific set of pages/routes you’d like it to run against?