L10 Glossary Terminology

title: "Glossary and Terminology Management for Localization" weight: 10 description: "Learn glossary and terminology management for documentation localization: creating term bases, managing translations, enforcing consistency, and tools for terminology management across locales." date: 2026-06-28 lastmod: 2026-06-28 tags: [technical-writing, localization] }

Glossary and terminology management ensures consistent translation of technical terms across all localized documentation, maintaining brand voice and technical accuracy.

In this lesson, you will learn how to create and manage glossaries, enforce terminology consistency, and use terminology management tools.

What You'll Learn

You will learn glossary creation, term translation management, consistency enforcement, and terminology management tools.

Why It Matters

Inconsistent terminology confuses users. If your product uses "compress" but one locale translates it as "squeeze" in some places and "compact" in others, users question the documentation quality.

def create_glossary_entry(term, definition, part_of_speech):
    """Create a glossary entry for translation consistency."""
    return {
        "term": term,
        "definition": definition,
        "pos": part_of_speech,
        "forbidden_translations": [],
        "notes": "",
    }

Teacher Mindset

Think of a glossary as a dictionary for your translators. Every term has one approved translation. This eliminates guesswork and inconsistency.

Common Mistakes

1. No Glossary

Without a glossary, different translators use different terms for the same concept.

2. Glossary Not Shared With Translators

A glossary stored in a drawer nobody opens ensures nothing.

3. Never Updating the Glossary

New features introduce new terms. Update the glossary with each release.

Practice Questions

1. What should a glossary entry include? Term, definition, approved translation, forbidden alternatives, and usage notes.

2. How do you enforce glossary compliance? Use QA tools that check translated content against the glossary.

3. Challenge: Create a glossary of 20 technical terms for your product.

FAQ

Mini Project

Create a bilingual glossary for your product. Include 20 key terms with approved translations, definitions, and usage examples. Share it with your translation team.

What's Next

Pseudo Localization in the next lesson.