Docs / The term block
The term block
One block type. Each ::: term block is one
term.
::: term id="dialect"
# Dialect
## Definition
A concrete Idiomd language variant: block specs plus renderers.
## Usage
- Lowercase as a code identifier (`adrmd`), capitalized in prose (Adrmd).
## Examples
+ "The Idiomd dialect Adrmd norms architecture decisions."
- "The Adrmd format" (hides the family membership).
## Synonyms
- Language variant
## Related
- kernel
Attributes
| Attribute | Type | Required | Constraints |
|---|---|---|---|
id | string | yes | stable registration key; anchor / link target |
status | string | no | one of draft, approved,
deprecated, rejected; default
approved — see lifecycle |
The id is the technical key (HTML anchor, JSON key,
target of Related/ReplacedBy references); the
# H1 title is the display form of the term.
Sections
Content type sectioned. A # H1 title is
required; only Definition is a required section.
| Section | Required | kind | Purpose |
|---|---|---|---|
Definition | yes | prose | what the term means |
Scope | no | prose | domain / sub-project the term applies to |
Usage | no | list | usage rules, imperative |
Examples | no | list +/− | correct / incorrect use |
Synonyms | no | list | equivalent display forms |
Related | no | list | ids of related terms |
ReplacedBy | no | list | ids of successor terms (for deprecated) |
Sources | no | list | references / standards / links |
Undeclared ## headings are tolerated per the kernel
rules. Each source line of a list section is one item —
keep list entries on one line.
Reference convention
Related and ReplacedBy entries are the
id values of other term blocks — one id per line, nothing
else. References are a convention, not a kernel-validated rule: the
kernel validates per block and does not check that a referenced id
exists. Consumers (e.g. renderers) SHOULD report dangling references
and duplicate ids as warnings.