[CI/a11y] Add automated heading-hierarchy / axe-core check to site_lint.yml
Nessuno ha ancora preso questa issue.
- Lingua principale
- JavaScript
- Stelle
- 11.8k
- Fork
- 7.9k
- Merge medio
- 1g 11h
- PR unite (30g)
- 11
Descrizione
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).
Additional Context
-
Discussed as a side note in PR https://github.com/reactjs/react.dev/pull/8607#pullrequestreview-4955873812.
-
Tooling suggestion: axe-core / eslint-plugin-jsx-a11y or a post-build HTML scan step in CI.
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia leggendo il workflow GitHub Actions site_lint.yml e la discussione sull’ordine delle intestazioni in PR 8607. Determina come si inserisce nel workflow esistente un controllo con axe-core, @axe-core/playwright, eslint-plugin-jsx-a11y o un controllo HTML post-build, quindi verifica che CI rilevi livelli di intestazione saltati come H1 → H3.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- github-actions, javascript
- Ambito
- accessibility, ci-cd, tooling
- Tipo di issue
- Funzionalità
- Difficoltà
- 3/5
- Tempo stimato
- 1-2 giorni
- Stato di attività
- Attiva
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 64/100