diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9e5223a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,4 @@
+# text.nix flake-parts module
+
+The option `text.<name>` supports either a string or a submodule with attributes order and parts.
+The parts attribute can either be a string, which will get concatenated in the order laid out in `text.<name>.order`, or can itself have the attributes order and parts, in which case it will be evaluated recursively.''