reactjs / reactjs/react.dev

[CI/a11y] Add automated heading-hierarchy / axe-core check to site_lint.yml

Ouverte
#8,610 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
JavaScript
Étoiles
11.8k
Forks
7.9k
Merge moyen
1 j 11 h
PR mergées (30 j)
11

Description

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

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par lire le workflow GitHub Actions site_lint.yml et la discussion sur l’ordre des titres dans PR 8607. Déterminez comment un contrôle avec axe-core, @axe-core/playwright, eslint-plugin-jsx-a11y ou une vérification HTML post-build s’intègre au workflow existant, puis vérifiez que CI détecte les niveaux de titre ignorés tels que H1 → H3.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
github-actions, javascript
Domaine
accessibility, ci-cd, tooling
Type d'issue
Fonctionnalité
Difficulté
3/5
Temps estimé
1-2 jours
Activité
Active
Clarté
Plutôt claire
Accessibilité débutants
64/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.