record architecture decisions

Yoast · Sep 3, 2021 · 9170a07 · 9170a07
1 parent 01ff920
commit 9170a07
Show file tree

Hide file tree

Showing 2 changed files with 24 additions and 0 deletions.
diff --git a/docs/.adr-dir b/docs/.adr-dir
@@ -0,0 +1 @@
+project-decisions
diff --git a/docs/project-decisions/0001-record-architecture-decisions.md b/docs/project-decisions/0001-record-architecture-decisions.md
@@ -0,0 +1,23 @@
+# 1. Record architecture decisions
+
+Date: 2021-09-03
+
+## Status
+
+Accepted
+
+## Context
+
+We need to record the architectural decisions made on this project.
+
+## Decision
+
+We will use Architecture Decision Records, as [described by Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions).
+
+- Architecture Decisions should be added through a pull request on the git repository.
+- Pull requests for Architecture Decisions should be reviewed by at least 2 members of the Tech Council.
+- Architecture Decisions will be effective immediately once the pull request has been merged to trunk.
+
+## Consequences
+
+- Pull requests should conform to all active Architecture Decisions.