Un glossaire est un système de décision
Une entrée utile contient terme préféré, définition, variantes interdites ou obsolètes, contexte et owner.
Commencer par les concepts qui créent du frottement
Priorisez les termes qui provoquent support, labels incohérents, problèmes de traduction ou débats de review.
Séparer concept et libellé
Un concept peut avoir plusieurs noms historiques. Modélisez-le une fois et conservez les aliases.
Intégrer la terminologie au workflow
Utilisez si possible la même source pour rédaction, traduction et linting.
Prévoir owners et révision
Les produits évoluent. La terminologie demande une maintenance continue.
Exemple pratique
Appliquez « Termes et définitions : construire un système terminologique » à 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
- Un glossaire est un système de décision. Une entrée utile contient terme préféré, définition, variantes interdites ou obsolètes, contexte et owner.
- Commencer par les concepts qui créent du frottement. Priorisez les termes qui provoquent support, labels incohérents, problèmes de traduction ou débats de review.
- Séparer concept et libellé. Un concept peut avoir plusieurs noms historiques.
- Intégrer la terminologie au workflow. Utilisez si possible la même source pour rédaction, traduction et linting.
