# Explanations Explanations of how it works and why it works that way. [Architecture](explanations/architecture.md) is the map — the pieces, and how a night flows through them. [Design decisions](explanations/design.md) is the argument: why the map looks like this, and the choices that have no ADR of their own. The [ADRs](explanations/decisions.md) record the turns that were taken, one argument each. ```{toctree} :maxdepth: 1 :glob: explanations/* ```