DocsConcepts
Glossary
Compact definitions for mediva's contract vocabulary.
| Term | Definition |
|---|---|
| contract | The .mdv.md rule file; the primary noun in prose. |
| schema | The same file, named this way only for the CLI option --schema and API variable names. |
| directive | A hidden Markdown HTML comment beginning <!-- mdv: and ending -->. |
| tag | A construct you attach rules to: block, table, list, taskList, evidenceList, choice, code, media, prose, document, front. Most wrap content (open + close); document and front are markers with no end tag. |
| rule | A check attached to a tag, such as required, minWords=N, or allChecked. |
| prop | The reference's column name for an attachable rule; a rule as it appears in a Props table. |
| atom | One token inside a directive; most user-facing atoms are rules, plus meta-atoms like severity overrides and structure atoms. |
| concern | What a diagnostic is about: syntax or state. |
| syntax / shape | The form of the Markdown: headings, fences, tables, and other structure. |
| state | The document's content, attestation, or external facts. |
| attestation | A human-owned claim of completion, such as a checked box or provided evidence. |
| field kind | The internal kind of a tag's body, such as prose, list, or table; user-facing docs should usually say tag or rule. |