The termd dialect
Spec version 1.0.0 · normative source:
termd-spec
(SPEC.md + blocks/term.json)
termd is the Idiomd dialect for term definitions — a glossary of
precisely defined project vocabulary. It builds entirely on the Idiomd
kernel: the shared fence syntax, frontmatter rules, the
sectioned convention, and the kind vocabulary
come from @idiomd/core; termd adds exactly one block type
on top and no new syntax.
Reference
| Page | Covers |
|---|---|
| The term block | attributes, sections, the reference convention — the complete block reference |
| Status lifecycle | draft / approved / deprecated / rejected and what each means for the register |
| Renderers | termd-renderer-html (register + articles) and termd-renderer-json (AI/tooling index) |
Frontmatter
dialect: termd is required (kernel rule). The OKF-aligned
optional keys — type, title,
description, resource, tags,
timestamp — are recommended where they apply; unknown keys
are always passed through unchanged. The default type for a
termd document is Glossary: the document is the OKF concept
unit, its term blocks are the entries.
---
dialect: termd
title: Byline glossary
type: Glossary
tags:
- glossary
---Conformance
A termd document is conformant if it is kernel-conformant, every
block is a term block, and every block satisfies the
attribute and section rules of the
block reference. The key words MUST, SHOULD,
and MAY in the spec follow RFC 2119.
Versioning
The dialect spec is versioned via specVersion in
dialect.json (SemVer), independently of the kernel spec and
of any package version. Minor versions add backward-compatible rules;
major versions may break.