Guide auditeur

Ce guide s’adresse aux auditeurs, reviewers et formateurs qui s’appuient sur a11yNot comme aide à la preuve et à la calibration, pas comme preuve de conformité d’un site client.

Cadrage : ni WCAG ni RGAA ne sont des outils ordonnés pour l’audit ; le site privilégie ACT + fiches Support, avec les Nots (failures illustrées) en annexe. Voir docs/CADRAGE-WCAG-RGAA-ACT.md.

Formateur : parcours pilote et place de Sligo/Repogo — Parcours formateur · rapport écosystème (doc) .

Intérêt de cette section

a11yNot répond à un manque : beaucoup de ressources montrent le « bon » accessibilité, peu montrent des erreurs isolées et reproductibles. Chaque page ici contient une violation volontaire, dans un cadre encadré — même idée que la démo W3C Before and After , mais découpée en fiches courtes.

Pourquoi ce site reprend ce corpus

• Former l’œil : relier une règle abstraite (WCAG, règle d’outil) à un rendu concret.
• Calibrer les outils : vérifier qu’axe, WAVE ou autre remonte bien le type de problème attendu sur la page.
• Préparer l’audit réel : entraînement sans confondre avec un constat sur un produit en production.

Cette version française ajoute navigation, cadre pédagogique et fiches auditeur (statut, observation, apport) autour des démos d’origine.

Support, ACT, Not — ordre recommandé

RGAA : test sur la grille officielle → index a11yNot (lookup) → ACT / note / situation ; Not si vous avez besoin de la démo. Le test RGAA implémente WCAG via des tests techniques — le raccord a11yNot passe surtout par failures et ACT, pas par « parcourir le site comme le PDF RGAA ».

Audit réel : un ordre par thème ou famille ACT est souvent plus rapide que la numérotation RGAA ou l’ordre des principes WCAG.

Détail : docs/NAVIGATION-ET-TYPES-CONTENU.md · docs/CADRAGE-WCAG-RGAA-ACT.md.

Trois statuts de Not

Les badges apparaissent sur chaque fiche Not. La documentation détaillée est progressive : les Nots les plus utiles en audit sont documentés en premier dans data/a11ynot/nots.yaml.

Protocole recommandé (une fiche)

1. Lire Pour l’auditeur (statut, en bref, apport).
2. Parcourir Début / Fin de l’exemple sans modifier le DOM.
3. Lancer un outil automatique adapté au type de Not (contraste, ARIA, formulaires…).
4. Compléter par test manuel si le critère l’exige (clavier, zoom 200 %, lecteur d’écran, désactivation CSS/images).
5. Ouvrir Code de cet exemple (Gist) pour lier la violation au snippet.
6. Noter dans votre rapport : règle, preuve (capture, extrait code), gravité — jamais « non conforme car similaire à a11yNot » sur un site client.

Ce que cette ressource ne remplace pas

• Une grille RGAA / WCAG appliquée au périmètre réel du site audité.
• Des parcours utilisateur complets (plusieurs pages, authentification, états dynamiques).
• Une décision de conformité : les Nots sont des micro-scénarios didactiques.

Enrichir le corpus

• Métadonnées auditeur : data/a11ynot/nots.yaml (voir Maintenance des fiches ).
• Regénération des démos Jekyll : scripts/convert_a11ynot_jekyll.py (ne pas écraser les champs not_status / doc sans fusion).
• Nouveaux Nots : slug sous content/, not_status: nouveau, démo isolée dans .rendered-not.