How to create a glossary entry
PURPOSE
Glossary entries explain terms, acronyms, and concepts users may not understand.
INCLUDE
Term, plain-language definition, context, related terms, and examples if helpful.
KEEP IT SHORT
A glossary entry should explain quickly, not become a textbook chapter.
USE CONSISTENT LANGUAGE
Match terminology used across documentation.
BEST PRACTICE
If an acronym appears often, define it before it starts acting smug.