atualizado em novembro de 2020
sejamos honestos, nem todos os glossários são tão úteis quanto precisamos que sejam. Alguns nos deixam com sobrancelhas levantadas como os dois senhores da foto acima. Outros nos frustram o suficiente para abandonar nossa busca pela compreensão. Escrever um glossário útil de termos requer um foco agudo nas necessidades dos leitores e uma mão hábil em linguagem simples.
depois de examinar muitos glossários, criei esta lista de 5 dicas para escrever um glossário que é realmente útil:
atender às necessidades do seu público.
as entradas em um glossário não são para você, são para o leitor. É vital considerar sua necessidade de compreensão, em vez de sua necessidade de concluir a tarefa. Pense em por que os leitores fazem referência aos glossários. Eles vêm para esclarecimento (“eu acho que sei o que isso significa”), validação (“Ha! Eu tinha razão. Sou tão esperto.”) ou elucidação (“então é isso que isso significa”). Mantenha as necessidades do público em mente ao criar suas definições.
Use linguagem simples.
há uma sensação de que a linguagem simples é chata ou emburrecida. Isso simplesmente não é verdade. A linguagem simples é cristalina. E é por isso que é crucial para a escrita do glossário. Não descreva a anemia como” tendo um hematócrito baixo ” porque você provavelmente precisa explicar o hematócrito também. Em vez disso: Anemia: uma condição na qual o corpo não tem glóbulos vermelhos suficientes. Muitas vezes detectado com um hematócrito, um exame de sangue medindo a porcentagem de sangue total que consiste em glóbulos vermelhos. Ao escrever um glossário para um público altamente técnico, não há problema em usar o jargão, mas mantenha-o no mínimo. Leia mais sobre o valor da linguagem simples.
não use a palavra na definição.
se você já procurou uma palavra e encontrou esse termo na definição, você sabe como isso é frustrante. Portanto, não faça isso com seus leitores. Por exemplo, Agile modeling session: uma sessão de modelagem que segue os princípios e aplica as práticas de modelagem ágil. (BTW, eu não inventei isso). Se eu não sei muito sobre Modelagem ágil ou o que acontece em uma sessão de modelagem ágil, tenho certeza de que não consegui descobrir isso com isso.
incluem sinônimos, antônimos e exemplos.
às vezes, podemos obter todas as informações de que precisamos para entender um Termo, observando seus sinônimos e antônimos. Inclua um ou dois de cada um em sua entrada no glossário. Exemplos também aumentam a compreensão. Não acreditas em mim? É assim que Merriam-Webster faz.
veja a entrada completa https://www.merriam-webster.com/thesaurus/antonym
obtenha mais informações sobre a importância da escolha de palavras.
fornecer dicas de pronúncia.
realmente ajuda saber como dizer a palavra corretamente, especialmente para abreviações que não são explicitadas. Nós nos referimos muito ao SPUG – é a nossa abreviação de ortografia, pontuação, uso e gramática. Mas não o soletramos. Ninguém aqui o chamaria de S-P-U-G. nós o chamamos de pug, como pug ou spud.Experimente estas dicas da próxima vez que tiver que definir um termo no seu conteúdo ou escrever um glossário inteiro. É um pouco mais de trabalho, mas a recompensa vem na forma de um público educado e apreciativo.
3 razões para criar um glossário
glossários são excelentes ativos de marketing de conteúdo” big rock ” que valem a pena por três razões. Eles:
- forneça valor legítimo ao seu público aumentando a compreensão
- impulsione a lealdade e a confiança atendendo às necessidades e fornecendo insígnias úteis
- incentive o compartilhamento com outras pessoas, estendendo seu alcance de marketing