From ade253eef801c0be2acdfdbaa8247e540d959ac2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jiri=20Dan=C4=9Bk?= <jdanek@redhat.com>
Date: Sat, 18 Jan 2025 14:17:49 +0100
Subject: [PATCH] NO-JIRA: chore(docs/adr): begin recording architectural
 decisions made on this project with the help of adr-tools

```
$ brew install adr-tools
$ adr init docs/architecture/decisions
```
---
 .adr-dir                                      |  1 +
 .../0001-record-architecture-decisions.md     | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+)
 create mode 100644 .adr-dir
 create mode 100644 docs/architecture/decisions/0001-record-architecture-decisions.md

diff --git a/.adr-dir b/.adr-dir
new file mode 100644
index 000000000..da5cac6b7
--- /dev/null
+++ b/.adr-dir
@@ -0,0 +1 @@
+docs/architecture/decisions
diff --git a/docs/architecture/decisions/0001-record-architecture-decisions.md b/docs/architecture/decisions/0001-record-architecture-decisions.md
new file mode 100644
index 000000000..a05db5bf6
--- /dev/null
+++ b/docs/architecture/decisions/0001-record-architecture-decisions.md
@@ -0,0 +1,19 @@
+# 1. Record architecture decisions
+
+Date: 2025-01-18
+
+## 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).