diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1140d2f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Modules
+
+The nixosModules and homeModules exposed by this flake are slightly out of the norm.
+
+Option declarations for user specific configuration are kept to:
+
+- homeModules for CLI
+- nixosModules for desktop
+
+System configurations, to this end, should include the window manager, lockscreen, terminal etc. for that system.
+
+These desktop programs will be **configured** in home-manager for each user, but those configurations consult the osConfig variable passed in by home-manager.