Generated by luria index from this project’s luria.yaml — built, not edited. A table configured is a row here whether or not anyone remembered to describe it.
This is the shape this project gave the record machinery: the document
families it named, where entries are filed, where views are rendered, and what
to type to add one. It is a description of luria.yaml as configured, not of
what luria.yaml can hold — for the key-by-key schema, with defaults and
meanings, see Luria’s configuration reference.
Referable documents
A code — ADR-012 — resolves to a document, and every reference to it in this repository is checked. luria lint fails on a bare code that was never linked; luria link --fix writes the link so nobody has to know where the document renders.
| a code looks like | filed in | rendered to | in force when status is |
|---|---|---|---|
CLAIM-001 | record/claims.d/ | docs/claims/README.md + tag pages | Active |
INF-001 | record/inferences.d/ | docs/inferences/README.md + tag pages | Active |
OBJ-001 | record/objections.d/ | docs/objections/README.md + tag pages | Active |
What each family is
A scheme’s own account of itself, where it gives one — title and blurb on schemes.X. The table above says where a family’s files live and how its codes are spelled; this says what the family is for, which is the part a reader needs first and the part a config could not previously state (#279).
What an entry must carry
Every entry carries title and date. Everything else is listed below rather than assumed: status and the axis are controlled fields the scheme declares, and every relation — the successor a retiring document names included — is a reference the scheme declares, with the conditions it states (ADR-071, ADR-125). What each scheme’s entries must carry, compiled from luria.yaml into the contract luria lint checks, with where each obligation was declared. A finding cites the same line.
CLAIM
premise_of— optional, one or moreINFcodes when present (luria.yaml: schemes.CLAIM.references.premise_of)status— optional, one ofActive,Proposed,Withdrawn(luria.yaml: schemes.CLAIM.fields.status; vocabulary ‘statuses’: values)
INF
premises— optional, one or moreCLAIMcodes when present (luria.yaml: schemes.INF.references.premises)concludes— optional, aCLAIMcode when present (luria.yaml: schemes.INF.references.concludes)status— optional, one ofActive,Proposed,Withdrawn(luria.yaml: schemes.INF.fields.status; vocabulary ‘statuses’: values)
OBJ
challenges— required, one or moreCLAIMorINFcodes (luria.yaml: schemes.OBJ.references.challenges)status— optional, one ofActive,Proposed,Withdrawn(luria.yaml: schemes.OBJ.fields.status; vocabulary ‘statuses’: values)
Journals
Dated observations. An entry is true about the day it was written and is never revised or consumed — the books are a view over sources that stay, which is what makes a journal safe to write into without coordinating.
| journal | entries filed at | books rendered to | one book per | titled |
|---|---|---|---|---|
devlog | record/devlog.d/ yyyy/mm/dd/hhmmss.md | docs/devlog/ | month | Development log |
Fragment directories
One file per contribution, assembled into a single document and then consumed. The point is the absence of a shared file to conflict on: every contributor writes a new path.
| directory | assembled into | style |
|---|---|---|
record/changelog.d/ | CHANGELOG.md | append |
Other projects this record cites
A prefixed code reaches into another project’s record, so a citation says whose decision it is at the point of use rather than leaving the reader to guess.
None configured.
Filing something new
Every kind this project scaffolds, straight from the dispatch table luria new itself uses.
| command | files |
|---|---|
luria new --kind changelog --title "…" | a fragment in record/changelog.d/ |
luria new --kind claim --title "…" | a document in the CLAIM scheme, numbered for you |
luria new --kind devlog --title "…" — or just luria new --title "…", the default kind | a dated entry in the devlog journal |
luria new --kind inf --title "…" | a document in the INF scheme, numbered for you |
luria new --kind migration --title "…" | a migration spec |
luria new --kind obj --title "…" | a document in the OBJ scheme, numbered for you |
Settings this project changed
Everything not listed here is at Luria’s default.
| key | this project | Luria’s default |
|---|---|---|
issue_url | https://github.com/acme/bridge/issues/{n} | empty |
chains.argument | 5 keys set | unset |
chains.uncontested | 5 keys set | unset |
patterns.follows_from | (b:CLAIM)<-[:concludes]-(i:INF)<-[:premise_of]-(a:CLAIM) | unset |
patterns.stands_on | 2 keys set | unset |
site.title | Argument map | empty |
vocabularies.statuses | 3 keys set | unset |