Skip to main content
Warning This document has not been updated for a while now. It may be out of date.
Last updated: 19 Sep 2019

govuk-docker: 0001-record-architecture-decisions

Date: 2019-09-19


We need to record the architectural decisions made on this project.

The original govuk-docker repo was written outside of GOV.UK. Major architectural decisions, as well as more minor decisions, were written as documentation in the repo, together with their associated user NEEDS. While these documents have historical value, they are not being maintained and increasingly differ from the current state of the repo. As part of adopting an ADR approach, we should clearly deprecate these historical documents to avoid confusion.


We will use Architecture Decision Records, as described by Michael Nygard in this article:




See Michael Nygard's article, linked above. For a lightweight ADR toolset, see Nat Pryce's adr-tools at

We will deprecate the historical DECISIONS and NEEDS documents, by writing a deprecation notice at the top of each document, and by moving them into the assets for this ADR.