sprig and prose docs classic docs
Reference› ADRs

ADRs

ADRs are documents that describe a decision. They're records of those decisions so that you can go back in time and remember why certain decisions were made. One of the most important parts of an ADR is documenting the rejected cases, or the ideas that never materialized into anything. The ideas that survive leave behind artifacts, but the ones that don't leave less of a trail.

Records

  • ADR001 FontPairing — Font pairing for the beta field guide UI. Accepted.
  • ADR002 NestedNameResolution — Nested name resolution. Accepted.
  • ADR003 EndpointDimensionPairs — Endpoint dimension relationship pairs. Accepted.
  • ADR004 NestedDimensions — Nested dimensions. Deferred.
  • ADR005 ProseSans — Prose sans for the beta field guide UI. Accepted.
  • ADR006 DimensionsInRelationships — Dimension relationship endpoints. Accepted.
  • ADR007 RelatesEndpointDimensionPairs — Relates endpoint dimension pairs. Accepted.
  • ADR008 RelationshipChainUniqueness — Relationship chain uniqueness. Accepted.
  • ADR009 RealityInTheFieldGuide — Receipts in the field guide. Accepted.
  • ADR010 TitleBlock — The title block. Accepted.
  • ADR011 ExpectsBlock — Expects block. Proposed.
  • ADR012 FileScopeUniverse — File-scope universe. Accepted.
  • ADR013 ExecutableLayer — Executable layer. Accepted.
  • ADR014 Literals — Literals. Accepted.
  • ADR015 MarkdownInDescribe — Markdown in describe. Accepted.
  • ADR016 UsingMarkdown — Using markdown. Accepted.
  • ADR017 LinksInDescribe — Links in describe. Accepted.
  • ADR018 TemporalDimensions — Temporal dimensions. Proposed.
  • ADR019 DeclaredDimensions — Declared dimensions. Accepted.
  • ADR020 MarkerPosition — Marker position. Accepted.
  • ADR021 VersioningPolicy — Versioning policy. Accepted.
  • ADR022 ReceiptBoundary — Receipt boundary. Accepted.
  • ADR023 ErrorNameCorrections — Error name corrections. Accepted.
  • ADR024 RelatesTargetsInPair — Relates targets must be in the pair. Accepted.
  • ADR025 RelationshipSideBlocks — Relationship side blocks. Accepted.
  • ADR026 ProjectionsStateTheirRules — Projections state their rules. Proposed.
  • ADR027 DatesAsNames — Dates as names. Accepted.
  • ADR028 RecordFactsInTheUniverse — Record facts in the universe. Accepted.
  • ADR029 EdgeBlocks — Edge blocks. Accepted.
  • ADR030 DescribeInEdgeBlocks — Describe in edge blocks. Proposed.
  • ADR031 BracesInProse — Braces in prose. Proposed.

What some pages leave out

A header line appears only where the universe records that fact. A record decided when it was written has no Recorded line, and a proposal has a Proposed line and no Decided line.

How this list is made

Every page is generated from the universe, so its header cannot disagree with it. Records appear under their number and name exactly as the universe spells them, with the title beside the name. The universe mirrors every link, so a page can show a link its own text never mentions: an earlier record lists what followed, revised or superseded it. The text under the header is the record's own file, copied as written from where sprig observe last found it, with links between records pointing at these pages. A record edited since the last observe shows its earlier text until observe and this projector run again. Records are listed by number, compared as spelled.