How to make a good glossary

Updated November 2020

laten we eerlijk zijn, niet alle woordenlijsten zijn zo nuttig als we nodig hebben. Sommigen laten ons met opgeheven wenkbrauwen achter, zoals de twee heren op de foto hierboven. Anderen frustreren ons genoeg om onze zoektocht naar begrip op te geven. Het schrijven van een nuttige woordenlijst van termen vereist scherpe focus op de behoeften van de lezers en een handige hand op eenvoudige taal.

na veel woordenlijsten te hebben bekeken, kwam ik met deze lijst van 5 tips voor het schrijven van een woordenlijst die echt nuttig is:

voldoen aan de behoeften van uw publiek.

de vermeldingen in een woordenlijst zijn niet voor u, ze zijn voor de lezer. Het is van vitaal belang om te overwegen hun behoefte aan begrip in plaats van uw behoefte om de taak te voltooien. Denk na over waarom lezers verwijzen naar woordenlijsten. Ze komen voor verduidelijking (“ik denk dat ik weet wat dit betekent”), validatie (“Ha! Ik had gelijk. Ik ben zo slim.”) of opheldering (“dus dat is wat dit betekent”). Houd de behoeften van het publiek in gedachten terwijl u uw definities maakt.

gebruik Gewone Taal.

men heeft het gevoel dat gewone taal saai of dom is. Dat is gewoon niet waar. Duidelijke taal is glashelder. Daarom is het cruciaal voor het schrijven van woordenlijsten. Beschrijf bloedarmoede niet als “het hebben van een lage hematocriet” omdat je waarschijnlijk nodig hebt om hematocriet te verklaren, ook. In plaats daarvan: bloedarmoede: een aandoening waarbij het lichaam niet genoeg rode bloedcellen. Vaak gedetecteerd met een hematocriet, een bloedtest die het percentage volbloed dat bestaat uit rode bloedcellen meet. Bij het schrijven van een woordenlijst voor een zeer technisch publiek, is het OK om jargon te gebruiken, maar houd het tot een minimum. Lees meer over de waarde van gewone taal.

gebruik het woord niet in de definitie.

als u ooit een woord hebt opgezocht en die term in de definitie hebt gevonden, weet u hoe frustrerend dit voelt. Dus doe het je lezers niet aan. Bijvoorbeeld, Agile modellering sessie: een modellering sessie die de principes volgt en de praktijken van agile modellering toepast. (BTW, dat heb ik niet verzonnen). Als ik niet veel weet over agile modelleren of wat er gebeurt in een agile modellensessie, dan kan ik hier zeker niet uit komen.

omvat synoniemen, antoniemen en voorbeelden.

soms kunnen we alle informatie krijgen die we nodig hebben om een term te begrijpen door te kijken naar de Synoniemen en antoniemen. Neem een of twee van elk in uw woordenlijst-item. Voorbeelden vergroten ook het begrip. Geloof je me niet? Zo doet Merriam-Webster het.

a screengrab of the thesaurus entry for antonym

zie de volledige entry https://www.merriam-webster.com/thesaurus/antonym

krijg meer inzicht in het belang van woordkeuze.

geef tips voor de uitspraak.

het helpt echt om het woord correct te zeggen, vooral voor afkortingen die niet zijn gespeld. We verwijzen vaak naar SPUG — het is onze afkorting voor spelling, interpunctie, gebruik en grammatica. Maar we spellen het niet. Niemand hier noemt het S-P-U-G. wij noemen het spug, zoals pug of spud.

probeer deze tips de volgende keer dat u een term in uw inhoud moet definiëren of een hele Woordenlijst moet schrijven. Het is een beetje meer werk, maar de pay-off komt in de vorm van een opgeleid en waarderend publiek.

3 Redenen om een glossarium te maken

glossaria zijn uitstekende” big rock ” content marketing activa die de moeite waard zijn om drie redenen. Zij:

  1. geef uw publiek een legitieme waarde door meer inzicht te krijgen in
  2. stimuleer loyaliteit en vertrouwen door te voldoen aan de behoeften en het verstrekken van nuttige insignt
  3. stimuleer het delen met anderen, waardoor uw marketingbereik wordt uitgebreid

Geef een antwoord

Het e-mailadres wordt niet gepubliceerd.