Comment ajouter une entrée de glossaire
Dans cet article, nous allons voir comment ajouter des entrées au glossaire MDN Web Docs et comment y faire référence. Il fournit également des directives sur la mise en page et le contenu des entrées du glossaire. Le glossaire fournit des définitions pour tous les termes, le jargon, les abréviations et les acronymes que vous rencontrez en lisant le contenu de MDN sur le Web et le développement Web.
Il est possible que le glossaire ne soit jamais complet, car le Web est en perpétuelle évolution. En contribuant à l'édition de nouvelles entrées ou en corrigeant les erreurs, vous pouvez nous aider à mettre à jour le glossaire et à combler les lacunes.
Contribuer au glossaire est une façon simple de rendre le Web plus compréhensible pour tout le monde. Il n'est pas nécessaire d'avoir des compétences techniques approfondies. Les entrées du glossaire sont conçues pour être simples et concises.
Note : La suite de cet article explique comment créer une entrée du glossaire. Toutefois, la structure du contenu de MDN utilise le contenu anglophone comme référence. Aussi, toute page doit d'abord être créée en anglais avant d'être localisée en français. Vous pouvez également aider à la traduction du glossaire en français, voir Localiser MDN.
Comment rédiger une entrée
Tout d'abord, choisissez un sujet pour lequel vous souhaitez écrire une entrée dans le glossaire. Si vous recherchez des sujets nécessitant une entrée dans le glossaire, consultez la liste des termes dans la barre latérale de la page d'accueil du glossaire.
Si vous avez une idée pour une nouvelle entrée, créez une nouvelle page pour ce terme, sous la page du glossaire.
Écrire un résumé
Pour toute page du glossaire, le premier paragraphe consiste en une description simple et concise du terme. Idéalement, ce paragraphe ne doit pas dépasser deux phrases. Assurez-vous que toute personne qui lit cette description peut immédiatement comprendre le terme qui est défini.
Note : Veillez à ne pas copier-coller de définitions ou de contenus provenant d'autres pages sur Internet. (Notamment depuis Wikipédia, les versions de sa licence sont plus restreintes et incompatibles avec celle de MDN). Le contenu de votre entrée de glossaire doit être original.
Rédiger une bonne entrée dans le glossaire
Ajoutez quelques paragraphes si nécessaire, mais attention au risque d'écrire un article complet. Un article complet est intéressant mais n'a pas sa place dans le glossaire. Si vous n'êtes pas certaine ou certain de l'emplacement de votre page, n'hésitez pas à nous contacter pour en discuter.
Voici quelques lignes directrices à garder à l'esprit pour écrire une bonne entrée de glossaire :
- Lorsque vous utilisez des termes ou des abréviations dans la description du terme, veillez à créer les liens correspondants. Généralement, cela consiste à créer des liens vers les autres pages du glossaire.
- Utilisez les termes associés appropriés avec des liens si cela peut être effectué sans que l'article soit difficile à suivre. Avoir un réseau de pages liées entre elles avec des liens utiles est plus simple à utiliser.
- Pensez aux mots-clés que vous utilisez lors d'une recherche pour trouver cette page. Essayez alors de les utiliser sur cette page (sans non plus que l'entrée devienne incohérente, longue ou difficilement lisible).
Ajouter des liens
Une entrée du glossaire doit toujours finir par une section Voir aussi. Dans cette section, on doit trouver des liens qui aident la lectrice ou le·la lecteur·ice à aller plus loin en découvrant plus de détails, ou en apprenant à utiliser la technologie associée.
Une bonne pratique consiste à organiser ces liens en trois groupes :
- Connaissances générales
-
Ces liens fournissent des informations généralistes à propos du terme ou du sujet. Il peut par exemple s'agir d'un lien vers une page Wikipédia correspondante.
- Référence technique
-
Ces liens fournissent des ressources avec des informations techniques détaillées, sur MDN ou d'autres sites.
- En apprendre plus
-
Ce sont des liens vers des tutoriels, des exercices, des exemples ou tout autre contenu éducatif qui aide à l'apprentissage.
Gérer les homonymies et ambigüités
Certains termes peuvent avoir plusieurs significations selon le contexte. Pour résoudre ces ambigüités, on suit les règles suivantes :
- La page principale du terme doit être une page de désambigüisation contenant la macro
GlossaryDisambiguation(angl.)). - Les sous-pages de cette page principale définissent le terme dans les différents contextes.
Prenons un exemple pour illustrer ce cas. Le terme signature peut avoir plusieurs sens, dans au moins deux contextes : la sécurité cryptographique d'une part, et les fonctions d'autre part.
- La page Glossary/Signature constitue la page de désambigüisation avec la macro
GlossaryDisambiguation(angl.)). - La page Glossary/Signature/Security est celle qui définit le terme dans le contexte de la sécurité.
- La page Glossary/Signature/Function est celle qui définit la signature d'une fonction.