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 |
|---|---|---|---|
LIT-001 | record/literature.d/ | docs/literature/README.md + tag pages | Active |
SOTA-001 | record/practices.d/ | docs/practices/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, tags and date, and one standard field is conditional: a retiring document names its successor — superseded_by: when status is Superseded, unless the scheme renames the pair (ADR-071). status itself is listed below rather than assumed: the words are the scheme’s own, declared like any other controlled vocabulary. Beyond those, 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.
LIT
status— optional, one ofActive,Rejected,Superseded(luria.yaml: schemes.LIT.fields.status; vocabulary ‘lit-statuses’: values)tags— required, one or more ofoptimization,stability,systems(luria.yaml: schemes.LIT.fields.tags; vocabulary ‘lit-tags’: values)source— at least one ofarxiv,doi,url(luria.yaml: schemes.LIT.field_groups.source)
SOTA
source— required, aLITcode (luria.yaml: schemes.SOTA.references.source)status— optional, one ofActive,Deferred,Superseded(luria.yaml: schemes.SOTA.fields.status; vocabulary ‘sota-statuses’: values)tags— required, one or more ofoptimization,stability,systems(luria.yaml: schemes.SOTA.fields.tags; vocabulary ‘lit-tags’: values)primary_topic— exactly one ofoptimization,stability,systems(luria.yaml: schemes.SOTA.fields.tags.groups.primary_topic)
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.
| cited as | project | repository | ref |
|---|---|---|---|
ARXIV-ADR-001 | arXiv | — | main |
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 devlog --title "…" — or just luria new --title "…", the default kind | a dated entry in the devlog journal |
luria new --kind lit --title "…" | a document in the LIT scheme, numbered for you |
luria new --kind migration --title "…" | a migration spec |
luria new --kind sota --title "…" | a document in the SOTA 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/anthology/issues/{n} | empty |
site.title | Knowledge base | empty |
vocabularies.lit-tags | 3 keys set | unset |
vocabularies.lit-statuses | 3 keys set | unset |
vocabularies.sota-statuses | 3 keys set | unset |