12. Glossary

Content

The most important domain and technical terms that your stakeholders use when discussing the system.

You can also see the glossary as source for translations if you work in a multi-language environment (i.e. in offshore development models).

Motivation

You should clearly define your terms, so that all stakeholders

  • have an identical understanding of these terme
  • do not use synonyms and homonyms

Form

  • A simple table with columns <Term> and <Definition>
  • Potentially more columns for translations
Term Definition
<Term-1> <definition-1>
<Term-2> <definition-2>

<insert glossary (and optionally translation) table >


Further Info

Examples and Tips

See here for questions related to glossary and terms.