docs: decisions harmonize with file tree

2025-10-03 17:06:14 +02:00
parent b1f6dd58f3
commit f9c8ed74e1
9 changed files with 17 additions and 27 deletions
--- a/docs/site/decisions/template.md
+++ b/docs/site/decisions/template.md
@@ -0,0 +1,24 @@
+## Decision record template by Michael Nygard
+
+This is the template in [Documenting architecture decisions - Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions).
+You can use [adr-tools](https://github.com/npryce/adr-tools) for managing the ADR files.
+
+In each ADR file, write these sections:
+
+# Title
+
+## Status
+
+What is the status, such as proposed, accepted, rejected, deprecated, superseded, etc.?
+
+## Context
+
+What is the issue that we're seeing that is motivating this decision or change?
+
+## Decision
+
+What is the change that we're proposing and/or doing?
+
+## Consequences
+
+What becomes easier or more difficult to do because of this change?