Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

About the reference

The reference section is the exact, terse layer under the rest of this site: what every command does, what every word means, and where the design decisions are written down.

What is authoritative

This site explains. The station repo decides. In order of authority:

  1. The ADRs in station/docs/adr/. Append-only; a changed decision gets a new ADR that supersedes the old one.
  2. The wire specs in station/docs/spec/.
  3. The design overview in station/docs/design/, which predates parts of the implementation and says so where it conflicts with an ADR.
  4. This site.

If a page here disagrees with an ADR, the page has a bug. Tell us.