# Glossary

Ptah's product, workflow, database-support, and compatibility terms, with the file that pins each one.

Source: https://docs.ptah.run/v0.8.1/reference/glossary/

import GlossaryList from '../../../components/GlossaryList.astro';

Every term below carries its definition, the page that uses it, and where a
definition is pinned, the file that decides it. Definitions come from one
source, `docs/site/src/glossary.ts`, so the same term cannot come to mean two
different things on two pages.

A page that uses a term links here rather than repeating the definition, so a
reader who meets a word for the first time has one place to go and the word has
one meaning.

<GlossaryList />

## Adding a term

Add it to `docs/site/src/glossary.ts` with its `group`, the `learnMore` page
that teaches it, and a `source` where a file in the repository pins the fact.
The list above renders from that map, so the term appears here without being
transcribed, and `check-glossary-coverage.mjs` refuses an entry that names a
page which does not exist.

Then link here from the pages that use it. The definition stays in the map and
is rendered in one place, which is what keeps a word from meaning one thing on
one page and something else on the next.