Decisions

Decision records - why a part of the workspace works the way it does, what else was considered, and what it costs.

A decision record explains one design choice that changed how a module behaves: the context, what was decided, the consequences and the alternatives that were turned down. Write one when a change needs more reasoning than a pull request description holds, and keep it once the change ships: the module pages describe how things work, the record why.

Copyright © 2026