Conventions
Project-specific rules — the ones a reader could not infer from the code.
Rules this project holds itself to, written down because the code cannot state them. They bind work inside this repository; nothing here is a constraint on a site that extends the layer.
A rule says what is done; an architecture decision says why it was chosen over the alternatives, and stays readable after the reasoning has left everyone's head. The decision log is append-only, which is why it sits apart from the pages here — those get edited when they change.
Was this page helpful?