feat: Introduce ADRs (#979)

Author: DafyddLlyr

.adr-dir

@@ -0,0 +1 @@
+doc/architecture/decisions

README.md

@@ -24,3 +24,10 @@ Running `docker-compose up` won't spin up [metabase](https://www.metabase.com/).
 To spin it up, run:
 
   `docker-compose --profile analytics up`
+
+
+#### Documentation
+
+This project uses Architecture Decision Records (ADRs) to record significant changes and decisions. Further details of this can be (found here)[https://github.com/theopensystemslab/planx-new/blob/main/doc/architecture/decisions/0001-record-architecture-decisions.md].
+
+For maximum visibility and discoverability, we recommend using the (GithHub discussions board)[https://github.com/theopensystemslab/planx-new/discussions] where possible.

doc/architecture/decisions/0001-record-architecture-decisions.md

@@ -0,0 +1,19 @@
+# 1. Record architecture decisions
+
+Date: 2022-06-28
+
+## 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).
+
+## Consequences
+
+See Michael Nygard's article, linked above. For a lightweight ADR toolset, see Nat Pryce's [adr-tools](https://github.com/npryce/adr-tools).