L’accessibilité commence dans la source
Un thème peut offrir bon contraste et navigation clavier, mais les auteurs décident encore si le contenu est compréhensible. Une mauvaise hiérarchie de headings, des liens sans sens, des screenshots sans alternative et des tableaux de mise en page ne se réparent pas de façon fiable avec CSS.
Les règles d’accessibilité doivent donc exister dans les templates et le review éditorial.
Utilisez une structure sémantique
Les headings expriment la hiérarchie, pas simplement une taille de police. Les listes restent des listes et les tableaux servent aux vraies relations tabulaires. Donnez aux pages des titles descriptifs et un ordre d’information prévisible.
Cela améliore aussi la recherche, la navigation et le reuse.
Écrivez des liens compréhensibles hors contexte
Évitez « cliquez ici ». Le texte du lien doit généralement identifier la destination ou l’action. Ne comptez pas uniquement sur la couleur pour exprimer un état.
Traitez les images comme de l’information
L’alt text communique ce que le lecteur doit tirer de l’image, pas chaque pixel. Une image décorative peut avoir un alt vide. Un screenshot pédagogique doit être accompagné d’un texte qui décrit l’action essentielle.
Pour un diagramme complexe, combinez un alt court et une explication plus longue dans le contenu.
Testez les patterns d’authoring
Automatisez les checks de alt manquant, headings et liens vides, mais testez aussi des pages représentatives au clavier et avec des outils d’accessibilité, y compris code, callouts, tabs et recherche.
L’accessibilité passe à l’échelle lorsque les patterns sûrs sont aussi les plus simples à utiliser.
Exemple pratique
Appliquez « WCAG 2.2 pour les équipes documentation : points de départ pratiques » à une page réelle. Choisissez un contenu avec titres, tableau, note, exemple, terme répété et au moins une action du lecteur. Relisez d’abord comme auteur, puis comme lecteur ignorant le vocabulaire interne du produit.
Notez des défauts observables :
- quelle structure porte un sens absent du texte simple ;
- quel terme change d’orthographe ou de sens ;
- quelle instruction dépend d’un contexte non indiqué ;
- quelle règle serait difficile à appliquer de façon cohérente en revue.
Une norme est utile lorsque deux éditeurs arrivent à des décisions proches sur le même contenu. Si une règle paraît juste mais ne peut pas être démontrée sur une page représentative, précisez-la, ajoutez un exemple ou réduisez sa portée.
Checklist éditorial rapide
- L’accessibilité commence dans la source. Un thème peut offrir bon contraste et navigation clavier, mais les auteurs décident encore si le contenu est compréhensible.
- Utilisez une structure sémantique. Les headings expriment la hiérarchie, pas simplement une taille de police.
- Écrivez des liens compréhensibles hors contexte. Évitez « cliquez ici ».
- Traitez les images comme de l’information. L’alt text communique ce que le lecteur doit tirer de l’image, pas chaque pixel.
