Glossary & Style Guide

What is a Glossary?

A Glossary is a tool for ensuring consistency in terminology. Glossaries are used to define unique words or phrases that are important to your brand and company. Industry lingo, brand names, and homonyms are all examples of common Glossary entries. A Glossary should include clear instructions on how you want Translators to handle such important terms in translation.  This helps identify the tone, voice, and definition you want your Translation Resources to convey in the translations. Adding details to a term can improve quality and efficiency in your translation process.

By design, a Glossary is meant to be a "living" document that changes as your content matures and evolves. Therefore, updating terms is encouraged. The following articles will assist you in Glossary management;

Glossary Best Practices

Here are some best practices for improving your Glossary quality:

Include industry or company-specific terms
Every company has its own lingo; terms that have a specific meaning when applied to your product or offering and might not always be clear to someone outside the company. Do you have any of those terms? Start listing them and add them to your Glossary list with a definition.

Add terms you do not need to be translated
Smartling offers a "Do Not Translate" option for each term in the Glossary. Use it for all those terms, such as industry or company-specific terms, acronyms, proper nouns, etc. that you do not want to be translated.

Go beyond a list of “Do Not Translate Terms"
While it can be very easy to just list the things that should remain in English, don’t forget that translation resources also use the Glossary on an ongoing basis as a reference to translate key terms consistently.

More is better
There is no limit to the number of terms you can add to a Smartling Glossary, so don’t be shy about adding to your Glossary. The more terms you include the easier it will be for the translation resources team to understand your content and message.

Always add a definition to your terms
For a Glossary term to be of any use to your translation resource team, always add one or more definitions, explain why it's in the Glossary, and how you want it translated or not translated.

Use Glossary Custom Fields for further reference.

Custom Fields on a Glossary allows for additional, non-standard information to be collected to each for each Glossary term. Once you create the Custom Field, you will have the option to include specific metadata for that Custom Field when you add a term to the Glossary

Include links to your definitions
Like the style guide, a Glossary can teach the translation resource team a lot about your tone and style. Make sure you let them know which reference material to follow, for example, a certain version of grammar or dictionary, even a specific site that uses similar terms.

Update your Glossary often
Take full advantage of the fact that Smartling lets you update your Glossary as you go, adding comments and new definitions whenever needed.

Clean-up your Glossary often
No more excuses for not cleaning up the Glossary! Smartling lets you remove terms manually or export your Glossary so that you can clean it up offline. Take a bit of time regularly to remove or edit unnecessary terms, terms that are no longer current to make sure the translation resource team does not use erroneous or out-of-date definitions and translations.

Be language-specific if needed
From one language to another, conventions, like tone, punctuation, capitalization, active/passive voice, etc. might not be the same. Make use of Smartling's ability to add multiple definitions to list language-specific variations.

Let your translation team decide how to translate (and sometimes not translate) terms you’ve added to the Glossary
Although you might be tempted to translate your own Glossary terms, leave it to the pros! They know better what term fits your instructions, and they also know what terms may need to be translated for some countries and not for others. For example, Japanese teams may even translate Do Not Translate terms while Danish teams might leave a lot in English.

Let Smartling do the work
With the newest version of Smartling, the platform will automatically identify good candidates for words and phrases to put in your Glossary. You can review this list and add items into your Glossary, to make it better and more relevant for your content. Using this feature periodically will make it even easier to keep your Glossary relevant.

Was this article helpful?