Architecture Decision Records
We use ADRs to document significant architectural decisions for the Lola project. ADRs are managed with adr-tools.
Quick Commands
# Create a new ADR
make adr-new use-mkdocs-for-documentation
# List existing ADRs
make adr-list
# Show help
make adr-help
ADR Status
| Status | Meaning |
|---|---|
| Proposed | Under discussion, not yet accepted |
| Accepted | Approved and in effect |
| Deprecated | No longer relevant |
| Superseded | Replaced by a newer ADR |
Writing ADRs
Use the template as a starting point. ADRs should be written before implementing significant changes to ensure decisions are documented and reviewed.