Skip to content

YAML Schema Reference

Glossarist concept data is stored as YAML files following the Glossarist concept model.

The YAML schemas for concept and localized_concept are available at the concept-model repository.

V2 and V3 schema

The concept model has two major schema versions:

  • V2 — The original format, with concepts and localized concepts in separate directories (concept/ and localized_concept/)
  • V3 — The current format, supporting grouped concepts (all localizations in a single file), extended designation types, and ontology alignment

Both formats are supported by glossarist-ruby for reading and writing.

Enum reference

Concept status

notValid, valid, superseded, retired

Classification

preferred, admitted, deprecated

Normative status

preferred, admitted, deprecated, superseded

Designation types

expression, abbreviation, symbol, letter_symbol, graphical_symbol, prefix, suffix

Source types

authoritative, lineage

Source status

identical, modified, restyled, context-added, generalisation, specialisation, unspecified

An open source project of Ribose