+++
title = "Decisions"
description = "The architecture decision records: why the firmware is built the way it is, and what each choice costs. Generated from docs/adr/ in the repository."
template = "guide-index.html"
page_template = "guide-page.html"
sort_by = "weight"
weight = 3

[extra]
eyebrow = "Developer docs"
+++

One page for each architecture decision: the choice, what it was chosen over, and its consequences. They are written when the decision is made and kept; a later decision that changes an earlier one says so. Generated from `docs/adr/` in the repository: edit those files, not these pages.