GEO GUIDE
Building a Glossary: Getting the Team to Speak One Language
Updated 2026-10-19 · this page makes no search or citation promises
The direct answer: a glossary removes the cost of “same word, different understanding” — across teams, for new members, and in customer-facing copy. Entry structure: term, definition (what it is and is not), an example, related terms. Glossaries are collected from real misunderstandings — every misunderstood word deserves a definition.
The direct answer: a glossary removes the cost of “same word, different understanding” — across teams, for new members, and in customer-facing copy. Entry structure: term, definition (what it is and is not), an example, related terms. Glossaries are collected from real misunderstandings — every misunderstood word deserves a definition.
Entry structure
- The definition states what the term is AND what it is not — the negative half clears up the most misconceptions.
- One positive example and one counter-example per entry.
- Related terms cross-reference each other, forming a network.
Where terms come from
- Words understood differently in a cross-team meeting — source one.
- Questions new members asked in their first month — source two.
- Words customers misunderstood in support or copy — source three.
Maintenance
- Periodic review: retire obsolete terms, add new ones.
- The glossary is a living document — every misunderstanding caused by a term is an improvement input.
- Owned: a quarterly review chaired by the docs owner.