doc/adr/01-lvm.md

@@ -0,0 +1,13 @@
+# PubSolarOS ADR 01: LVM on luks as default for drive management
+
+In the context of drive mounting and disk partitioning,
+
+facing a fragmented ecosystem,
+
+we decided for LVM on luks with encrypted swap as the assumed default installation type,
+
+and neglected luks on LVM, unencrypted installs, or non-LVM install methods,
+
+to achieve a streamlined and opiniated nix config, an increased flexibility in partitioning, and more secure defaults,.
+
+accepting a more laborious setup.

doc/adr/README.md

@@ -0,0 +1,3 @@
+# Architectural Decision Records
+
+**For an explanation of ADR, see https://adr.github.io/**

doc/adr/TEMPLATE.md

@@ -0,0 +1,27 @@
+# Long form
+
+In the context of <use case/user story u>,
+
+facing <concern c>
+
+we decided for <option o>
+
+and neglected <other options>,
+
+to achieve <system qualities/desired consequences>,
+
+accepting <downside d/undesired consequences>,
+
+because <additional rationale>.
+
+# Short form
+
+In the context of <use case/user story u>,
+
+facing <concern c>
+
+we decided for <option o>
+
+to achieve <quality q>,
+
+accepting <downside d>.