Merge branch 'decision-log' into 'main'

docs: start a decision log

See merge request subplot/subplot!221

1 files changed, 24 insertions, 0 deletions

diff --git a/DECISIONS.md b/DECISIONS.md
new file mode 100644
index 0000000..2c22bc6
--- /dev/null
+++ b/DECISIONS.md
@@ -0,0 +1,24 @@
+# Big decisions made by the Subplot project
+
+In the [2021-09-11 meeting][] we decided to start keeping a decision
+log: a log of big decisions, often architectural ones. This file is
+that log. Decisions should be discussed before being made so that
+there is a strong consensus for them. Decisions can be changed or
+overturned if they turn out to no longer be good. Overturning is a
+decision.
+
+[2021-09-11 meeting]: https://subplot.liw.fi/blog/2021/09/11/meeting/
+
+Each decision should have its own heading. Newest decision should come
+first. Updated or overturned decisions should have their section
+updated to note their status, without moving them.
+
+
+## Start decision log
+
+Date: 2021-09-11
+
+What: We decided to start keeping a decision log for big, often
+architectural decisions affecting the project as a whole.
+
+Who: Daniel, Lars.