Skip to content

Defining a glossary

A glossary is a collection of semantic definitions, typically focused on defining the meaning of data. The process of building a glossary is iterative and collaborative. It switches between creating a overview of the content and then drilling down into the specifics, increasing the precision, before returning to review the overall consistency of the definitions.

Often organizations begin with a simple exercise to identify the broad topics that need to be covered. These broad topics are called Subject Areas. In an earlier scenario, Erin Overview created an initial list of Subject Areas for Coco Pharmaceuticals.

In this scenario, Erin is working with Faith Broker the director for human resources on the employee data subject area.

What are the initial list of key concepts?

Erin and Faith begin by identifying key concepts and create a short description for each one. Each of these concepts will be recorded in a glossary term. The descriptions often reveal new concepts that need explaining.

The notes identify points to investigate and expand on.

Figure 1

Figure 1: Defining the initial list of terms

Drilling down to fill out more information

Taking each concept in turn, Erin and Faith start to flesh out more detail in its glossary term. Important concepts can have a detailed description, examples, usage descriptions, images and other media clips to help educate a reader on the meaning of the term.

Again as more detail is created new related concepts emerge.

Figure 2 shows an exercise where the work location concept is expanded with detail of the data likely to be associated with a work location. Term relationship begin to appear.

Figure 2

Figure 2: Refining Work Location

Figure 3 shows common core types of data - postal address in this case - being identified as the same substructures appear in multiple places.

Figure 3

Figure 3: Redefining Postal Address

Figure 4 shows specializations of concepts being linked into a type hierarchy.

Figure 4

Figure 4: Defining Manager

As new concepts are added to the glossary, Erin and Faith make choices on how much detail to add to its glossary term depending on its importance - and the need to uncover new concepts.