lexicon.unexplained-abbreviation
Abréviations non explicitées.
Ce que cette règle signale
Les acronymes employés sans définition proche. Chaque interruption forcée pour deviner ou chercher un acronyme casse le fil et augmente le risque de perdre l’attention.
Références. WCAG 2.1 SC 3.1.4 (Abréviations) ; RGAA 9.4.
En bref
| Catégorie | lexicon |
| Sévérité par défaut | warning |
| Poids par défaut | 1 |
| Langues | EN · FR (listes blanches distinctes) |
| Source | src/rules/unexplained_abbreviation.rs |
Détection (v0.2, deux passes — F9)
-
Pré-scan du document entier pour repérer les acronymes définis sous l’une ou l’autre forme canonique :
Expansion complète (ACRONYME)— exemple :World Wide Web (WWW)ACRONYME (Expansion complète)— exemple :WWW (World Wide Web)
Le côté « expansion » doit contenir au moins deux mots alphabétiques, pour que des notes courtes entre parenthèses comme
(TBD)ou(à vérifier)ne soient pas comptées comme définitions. -
Appariement des séquences de 2 lettres capitales consécutives ou plus (optionnellement avec des chiffres) dans le texte principal.
-
Filtrage de chaque candidat par trois couches, dans l’ordre :
- Défini dans le document (issu du pré-scan) — le plus fort.
- Liste blanche utilisateur
[rules.unexplained-abbreviation].whitelist. - Liste blanche de base (pilotée par le profil).
-
Signalement de chaque occurrence restante.
Une seule définition n’importe où dans le document fait taire chaque occurrence du même acronyme — ce qui correspond à la manière dont les lecteurs utilisent réellement la documentation (remonter une fois pour trouver l’expansion, la retenir ensuite).
Paramètres
| Clé | Type | dev-doc | public | falc |
|---|---|---|---|---|
min_length | int | 3 | 2 | 2 |
whitelist | list | étendue | minimale | vide |
Liste blanche par défaut (v0.2, resserrée par F31) : la pile
d’infrastructure — URL, HTML, CSS, JSON, XML, HTTP, HTTPS, UTF, IO, API, CLI, GUI, OS, CPU, RAM, SSD, USB, IDE, SDK, CI, CD — plus les
acronymes FR/EN courants et les mots-clés d’emphase RFC 2119
(PDF, SMS, GPS, ID, OK, FAQ, MUST, SHALL, SHOULD, …).
[rules.unexplained-abbreviation]
whitelist = ["WCAG", "ARIA", "ADHD", "LLM"]
Les entrées de la liste blanche utilisateur sont additives par rapport à la liste de base — elles l’étendent, jamais ne la remplacent.
Neutralisation
Voir Neutralisation des diagnostics (page EN pour l’instant).
Voir aussi
lexicon.jargon-undefined— l’équivalent pour les mots de contenu.
Références
Voir Références pour la bibliographie complète.