Repérer les mots qui empêchent de comprendre le sujet
Quelques articles d’une rubrique suffisent pour un premier relevé. Un collègue qui ne les a pas écrits note les passages où un mot l’arrête, ainsi que les sigles et les emplois contradictoires. L’équipe peut rapprocher ces observations des questions reçues des lecteurs. Elle garde l’origine de chaque remarque : un obstacle supposé et une demande effectivement reçue n’apportent pas le même témoignage.
Prenons un exemple fictif : un média prépare un dossier sur la rénovation d’un quartier. Il rencontre des noms d’organismes, des acronymes de procédures et des mots courants employés dans un sens administratif. Le glossaire ne devrait pas tous les traiter avec la même longueur. Le nom développé d’un organisme peut suffire dans une phrase ; une notion dont dépend la compréhension du projet demandera peut-être une explication et une source.
Le W3C, dans son explication du critère 3.1.3, traite des mots employés dans un sens inhabituel ou spécialisé, notamment le jargon. Ce critère de niveau AAA prévoit un moyen d’en identifier la définition. Cette référence aide à penser les besoins de compréhension ; elle ne signifie pas que tout site doit publier un glossaire pour atteindre un autre niveau de conformité.
Pour choisir les premières entrées, la rédaction peut retenir les termes qui reviennent et dont la mauvaise compréhension change le sens d’un article. Un mot rare mais secondaire peut être expliqué directement à l’endroit où il apparaît. La fréquence seule ne décide pas de l’utilité : un terme présent une seule fois peut porter toute la distinction entre une décision déjà prise et un projet encore discuté.
Développer les sigles là où le lecteur les découvre
Un glossaire ne dispense pas d’expliquer un sigle lors de sa première apparition utile dans un article. Un lecteur peut arriver directement depuis une recherche ou un partage, sans avoir vu la page de présentation du dossier. Une formulation développée au début lui évite un détour ; le glossaire peut apporter ensuite une précision ou un rappel.
Le critère 3.1.4 consacré aux abréviations, lui aussi de niveau AAA, porte sur l’accès à leur forme développée ou à leur sens. Le W3C souligne que certaines abréviations peuvent avoir plusieurs significations. Pour la rédaction, cela invite à examiner le contexte de lecture, plutôt qu’à considérer les majuscules comme une explication suffisante.
Développer toutes les lettres n’aide pas toujours. Le nom officiel peut être plus obscur que le sigle. Une courte phrase sur le rôle de l’organisme sera alors plus utile qu’une expansion isolée. Dans notre exemple, le lecteur cherche à savoir qui prend la décision et qui réalise les travaux. La définition devrait lui permettre de distinguer ces rôles, à partir de sources vérifiées.
Le sigle peut aussi apparaître avant toute explication, dans le titre ou dans le partage social. Quand il est peu connu, l’équipe peut chercher une formulation qui annonce le sujet sans exiger de le reconnaître. Le relais gardera sa longueur propre. Il doit au moins permettre de comprendre pourquoi ouvrir l’article, sans compter sur un glossaire que le lecteur n’a pas encore vu.
Écrire une définition située et vérifiable
La définition doit d’abord résoudre la difficulté rencontrée dans la phrase. Si le terme possède plusieurs sens, l’entrée précise celui qui s’applique au dossier. Présenter toutes les acceptions dans le même paragraphe laisserait au lecteur le travail de choisir, alors que c’est précisément ce choix qui l’a arrêté.
L’équipe peut préparer chaque entrée avec le terme, une explication courte, la source utilisée et, si nécessaire, un exemple explicitement présenté comme tel. Ce cadre sert au travail de rédaction ; il n’oblige pas à publier une fiche uniforme pour chaque mot. Certains termes n’exigeront qu’une phrase. D’autres auront besoin d’une limite, d’une distinction avec un mot voisin ou d’un lien vers un article plus développé.
Dans le dossier fictif sur le quartier, un même sigle pourrait désigner des organismes différents selon le territoire. Une expansion trouvée sur un moteur ne suffit donc pas. Le journaliste revient au document local ou à l’organisme concerné pour vérifier le sens utilisé dans le reportage. Le glossaire doit aider à lire ce dossier précis, sans transformer un emploi local en définition universelle.
Une explication simplifiée ne doit pas modifier les conditions d’application d’une notion. Si le mot appartient à un domaine juridique, médical ou technique, la formulation doit être revue avec une personne compétente lorsque l’enjeu le demande. Le lien vers une source permet de vérifier le périmètre, mais ne rend pas juste une paraphrase approximative. L’objectif est de réduire la difficulté de lecture tout en conservant les limites nécessaires.
Choisir entre une explication locale et une page commune
Une définition utilisée dans un seul article peut rester près du passage concerné. Un encadré court ou une phrase dans le texte évite de créer une destination supplémentaire à entretenir. Lorsque plusieurs articles emploient la même notion dans le même sens, une page de glossaire commune devient plus intéressante : elle rassemble les références et facilite les mises à jour.
La longueur des explications et la place disponible comptent aussi. Un petit glossaire peut tenir dans le dossier. Une liste plus importante demandera des intertitres faciles à parcourir ou un sommaire. Le guide sur les ancres dans un article long détaille la navigation vers une section précise. Il permet de préparer des liens qui arrivent à la bonne entrée, plutôt qu’en haut d’une longue page.
Une recherche dans les anciens articles peut retrouver une explication déjà rédigée. Avant de la reprendre, il faut voir si elle reste juste hors du reportage qui la contenait. La rédaction choisit ensuite la version de référence et les liens à établir. Sans cette décision, chaque copie pourra évoluer séparément, jusqu’à donner plusieurs réponses au même lecteur.
Une entrée peut rester une section de la page commune. Si elle tient en quelques phrases et n’a pas d’autre apport, une section dans une page commune peut suffire. Google recommande d’évaluer l’utilité et l’apport propre des contenus. Cette documentation ne garantit ni classement ni citation par une IA ; elle ne fournit pas non plus de nombre magique de mots pour une définition.
Vérifier le parcours au moment de la lecture
Une explication correcte peut rester difficile à trouver. La recette commence donc depuis un article qui utilise le terme, sur la page publique. Le lien mène-t-il à la bonne définition ? Son libellé permet-il de prévoir ce qui s’ouvre ? Le lecteur peut-il retrouver le passage initial après avoir consulté l’explication ? Ces questions concernent le parcours réel, pas seulement l’existence du glossaire dans le CMS.
Il vaut mieux que l’information essentielle puisse se lire sans devoir placer précisément une souris sur un mot. Si le site utilise des bulles ou des panneaux, leur fonctionnement doit être testé au clavier et sur mobile par la personne chargée du thème. Pour un premier glossaire, des liens ordinaires vers des définitions visibles peuvent simplifier le travail de publication et de maintenance.
Pour éprouver le texte, un collègue extérieur à la rubrique peut lire le passage, ouvrir l’entrée puis reformuler ce qu’il a compris. Sa réponse montrera peut-être que la définition tourne en rond ou laisse deux notions confondues. L’équipe dispose alors d’un défaut précis à reprendre. Cet essai qualitatif ne mesure pas la compréhension de l’ensemble du public.
Dans WordPress ou un autre CMS, la rédaction vérifie également le rendu enregistré, et pas seulement l’aperçu d’édition. Une modification du titre d’une entrée ne doit pas laisser les liens existants pointer vers une section disparue. Le contrôle peut porter sur quelques articles représentatifs du dossier, notamment les plus anciens, qui ont parfois conservé une ancienne formulation du terme.
Prévoir qui corrige les définitions et leurs liens
Un glossaire doit avoir un responsable identifiable dans l’équipe. Une entrée peut évoluer parce qu’un organisme change de nom, parce qu’un dispositif est remplacé ou parce que la rédaction découvre une imprécision. La fiche interne peut conserver la source et la date de vérification pour éviter de repartir de zéro à chaque doute.
La mise à jour demande de regarder les articles qui renvoient à l’entrée. Une nouvelle définition peut convenir aux publications récentes tout en rendant un ancien reportage trompeur. Si un terme avait un autre sens à la date des faits, une mention historique sera parfois nécessaire. Actualiser une référence ne doit pas réécrire silencieusement le contexte de tous les articles qui l’utilisent.
Le maillage d’un dossier éditorial aide à organiser ces relations. Pour le glossaire, le besoin est précis : connaître les principaux points d’entrée et repérer les liens qui doivent être revus lors d’un changement. Une liste interne simple peut suffire au départ. Il n’est pas nécessaire de lancer une refonte du site pour entretenir quelques définitions importantes.
La revue peut se concentrer sur les entrées sensibles ou touchées par un changement connu. Un terme resté juste ne demande pas une nouvelle date publique à chaque contrôle. En revanche, lorsqu’une définition est corrigée, la note interne précise pourquoi : le collègue qui la reprendra comprendra la décision sans refaire toute la recherche.
Commencer par les définitions dont les articles ont besoin
Pour un premier essai, le média peut choisir une rubrique et quelques entrées issues de ses textes existants. Il vérifie les sources, rédige les explications et relit les passages qui y renvoient. Le nombre d’entrées importe moins que la possibilité de les maintenir. Une liste courte permet de voir les difficultés avant de généraliser le format.
Au bilan, l’équipe reprend les passages qui posaient problème. Un sigle est-il désormais compréhensible ? Le lien arrive-t-il à l’explication attendue ? Une définition peut aussi être supprimée si l’article suffit à expliquer le mot. Ce retour aux textes permet de décider quelles entrées conserver et lesquelles revoir, avant d’étendre le glossaire à d’autres rubriques.
Sources officielles
Documents utilisés pour vérifier les points techniques de cet article.