How to make a good glossary

Updated November 2020

Let ’ s be honest, not all glossaries are as need to be. Jotkut jättävät meille kohotetut kulmakarvat, kuten kaksi herraa yllä olevassa kuvassa. Toiset turhauttavat meitä niin paljon, että hylkäämme ymmärryksen etsimisen. Hyödyllisen sanaston kirjoittaminen vaatii tarkkaa keskittymistä lukijoiden tarpeisiin ja taitavaa selkokieltä.

luettuani paljon sanastoja, keksin tämän listan 5 vinkkiä sanaston kirjoittamiseen, joka on todella hyödyllinen:

täytä yleisösi tarpeet.

sanaston merkinnät eivät ole sinua varten, ne ovat lukijaa varten. On tärkeää ottaa huomioon heidän ymmärryksen tarpeensa eikä sinun tarpeesi suorittaa tehtävä loppuun. Mieti, miksi lukijat viittaavat sanastoihin. Ne tulevat selventämään (”luulen tietäväni, mitä tämä tarkoittaa”), validoimaan (”Ha! Olin oikeassa. Olen niin fiksu.”) tai selvennys (”niin sitä tämä tarkoittaa”). Pidä yleisön tarpeet mielessä, kun luot määritelmiä.

käytä selkokieltä.

on tunne, että Selkokieli on tylsää tai mykistävää. Se ei ole totta. Selkokieli on kristallinkirkasta. Siksi se on ratkaisevan tärkeää sanaston kirjoittamisessa. Älä kuvaa anemia ”ottaa alhainen hematokriitti” koska luultavasti täytyy selittää hematokriitti, liian. Sen sijaan: Anemia: tila, jossa elimistö ei ole tarpeeksi punasoluja. Usein havaittu hematokriitti, verikoe, joka mittaa kokoveren prosenttiosuutta, joka koostuu punasoluista. Kun kirjoitat sanastoa erittäin tekniselle yleisölle, on OK käyttää ammattikieltä, mutta pidä se minimissä. Lue lisää selkokielen arvosta.

sanaa ei käytetä määritelmässä.

jos olet joskus etsinyt sanan ja löytänyt sen termin määritelmästä, tiedät kuinka turhauttavalta tämä tuntuu. Älä siis tee sitä lukijoillesi. Esimerkiksi Agile modeling session: mallinnussessio, joka noudattaa ketterän mallinnuksen periaatteita ja käytäntöjä. (BTW, en keksinyt sitä). Jos en tiedä paljon ketterä mallinnus tai mitä tapahtuu ketterä mallinnus session, en varmasti kuin ammunta voisi selvittää sitä tästä.

sisältää synonyymit, antonyymit ja esimerkkejä.

joskus saamme kaiken termin ymmärtämiseen tarvittavan tiedon katsomalla sen synonyymeja ja antonyymejä. Sisällytä yksi tai kaksi kutakin sanastoon. Esimerkit lisäävät myös ymmärrystä. Etkö usko minua? Niin Merriam-Webster tekee sen.

 a screengrab of the thesaurus entry for antonym

See the full entry https://www.merriam-webster.com/thesaurus/antonym

Lue lisää sananvalinnan tärkeydestä.

Anna ääntämisvinkkejä.

se todella auttaa, että osaa sanoa sanan oikein, varsinkin lyhenteissä, joita ei ole kirjoitettu. Me viittaamme SPUGIIN paljon — se on pikakirjoituksemme oikeinkirjoitukseen, välimerkkeihin, kielioppiin ja kielioppiin. Mutta emme tavoita sitä. Kukaan täällä ei kutsuisi sitä S-P-U-G: ksi.kutsumme sitä spugiksi, kuten pug tai spud.

kokeile näitä vinkkejä seuraavan kerran, kun joudut määrittelemään jonkin termin sisällössäsi tai kirjoitat kokonaisen sanaston. Se on vähän enemmän työtä, mutta palkka tulee koulutetun ja arvostavan yleisön muodossa.

3 syytä luoda sanasto

sanastot ovat erinomaisia ”big rock” – sisältömarkkinointivaltteja, jotka ovat efforin arvoisia kolmesta syystä. He:

  1. tarjoa laillista arvoa yleisöllesi lisäämällä ymmärrystä
  2. aja uskollisuutta ja luottamusta vastaamalla tarpeisiin ja tarjoamalla hyödyllistä insignt
  3. kannusta jakamaan muiden kanssa, laajentamalla markkinointiasi

Vastaa

Sähköpostiosoitettasi ei julkaista.