Add decision log with ADR-lite format (#52)

* Add decision log with ADR-lite format (#49)

Create docs/decisions.md seeded with 6 historical decisions reconstructed
from closed issues and meeting notes. Update CONTRIBUTING.md with guidance
on when to add decision log entries and add to README documents table.

* Address review feedback: reframe Decision 1 scope, fix relative links
This commit is contained in:
Peter Alexander 2026-03-12 14:48:01 +00:00 • committed by GitHub
commit 4dcb59d6c0
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -59,6 +59,16 @@ When adding quotes or input from community discussions:
- Link to the original source (Discord thread, GitHub comment, etc.) where possible
- Present input as blockquotes to distinguish it from editorial content
### Decision Log
Significant decisions made during meetings or through async discussion should be recorded in [docs/decisions.md](docs/decisions.md) using the ADR-lite format defined there. A decision is worth logging when it:
- Chooses one approach over alternatives
- Sets or changes the group's scope
- Establishes a convention or coordination mechanism
Add a new entry after the meeting where the decision was made or when rough consensus is reached asynchronously. Include context, the decision itself, rationale, and links to relevant issues, PRs, or discussion threads.
### Filing Issues
Use GitHub Issues for: