From 17cbdc44a6b868f47d55f5bd23b2e5cf501874d0 Mon Sep 17 00:00:00 2001
From: Alexander Weidinger <aw@sz9i.net>
Date: Wed, 12 Jul 2017 16:56:57 +0200
Subject: [PATCH] Added users-formula to README.rst

---
 README.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

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'
+```