Schema Element Metadata
There are various slots that can be used to provide metadata about either a schema or elements of a schema. These typically don’t affect the semantics of the model, but rather act as annotations that can be used to provide more information to people, or that can guide the behavior of some tools.
The description slot can be used to provide a human-readable description of any schema element
Person: is_a: NamedThing description: >- A person (alive, dead, undead, or fictional).
descriptions can include markdown
Person: is_a: NamedThing description: :- A human being including those that are: * alive * dead * undead * fictional
However, this is only recommended for schema descriptions.
This guide to yaml formatting may be helpful
The aliases slot can be used to define a list of aliases for a class or slot. This is useful for adding synonymous names to your class (or slot), that serve either as hints for human users, or to enhance search and findability over your model
Person: aliases: - human being - individual
See CommonMetadata for other slots