diff --git a/README.rst b/README.rst
index 543a712..47d0464 100644
--- a/README.rst
+++ b/README.rst
@@ -51,3 +51,19 @@ This depends on the vim-formula to be installed.
 ---------------
 
 Permits the abitrary management of files. See pillar.example for configuration details.
+
+Overriding default values
+=========================
+
+In order to separate actual user account definitions from configuration the pillar `users-formula` was introduced:
+
+```yaml
+users:
+  myuser:
+    # stuff
+
+users-formula:
+  lookup:
+    root_group: toor
+    shell: '/bin/zsh'
+```