diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..13aec4d
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,7 @@
+# niksos documentation
+
+this directory is a place for me to write down things about this flake I don't want to remember
+
+the documentation is made by me for me primarily but might help you understand this config or the decisions I make
+
+if you find something unclear feel free to let me know and I might improve it