<aside>
🏁
FRONT MATTER
Establishing common terminology is incredibly important.
A glossary is a useful tool for keeping the team aligned and ensuring we all mean what we think we do.
Some common things to include:
- All the acronyms
- How the partner refers to
- themselves
- the agency
- the teams involved
- end users
- internal users
- Name of the product/effort
</aside>
Suggested columns
- Term/Acronym
- Putting terms and acronyms together helps with alphabetizing, since most times the acronym is the common reference
- Expand acronym
- If it is an acronym, spell out the full term
- Verify this with multiple sources
- Meaning
- Define the concept or explain the acronymn
- Notes
- Category
- Categories can be helpful when you’re crossing a lot of domains - technology, process, policy…
- Link/Source
Some example glossaries
From past 18F projects
EXAMPLE: Glossary - DoS Passport Adjudications 2024-25