Add ADRs using the template

.rladr

@@ -0,0 +1 @@
+adr

Gemfile

@@ -51,6 +51,7 @@ group :development, :test do
 end
 
 group :development do
+  gem 'rladr'
   # Use console on exceptions pages [https://github.com/rails/web-console]
   gem "web-console"
 

Gemfile.lock

@@ -160,6 +160,7 @@ GEM
     rake (13.0.6)
     reline (0.3.1)
       io-console (~> 0.5)
+    rladr (1.2.0)
     rspec (3.11.0)
       rspec-core (~> 3.11.0)
       rspec-expectations (~> 3.11.0)
@@ -223,6 +224,7 @@ DEPENDENCIES
   importmap-rails
   puma (~> 5.0)
   rails (~> 7.0.3)
+  rladr
   rspec
   rspec-rails
   sprockets-rails

README.md

@@ -14,16 +14,14 @@ A service that allows teachers to apply for QTS (Qualified Teacher Status).
 Apply for qualified teacher status is a monolithic Rails app built with the
 GOVUK Design System and hosted on GOVUK PaaS.
 
-TODO: ADRs
+We keep track of architecture decisions in [Architecture Decision Records
+(ADRs)](/adr/).
 
-<!-- We keep track of architecture decisions in [Architecture Decision Records -->
-<!-- (ADRs)](/adr/). -->
+We use `rladr` to generate the boilerplate for new records:
 
-<!-- We use `rladr` to generate the boilerplate for new records: -->
-
-<!-- ```bash -->
-<!-- bin/bundle exec rladr new title -->
-<!-- ``` -->
+```bash
+bin/bundle exec rladr new title
+```
 
 ## Setup
 

adr/00001-record-architecture-decisions.md

@@ -0,0 +1,20 @@
+# 1. Record architecture decisions
+
+Date: 2022-05-10
+
+## 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).