From 80d3fc7822b97ebc368d04ec8869e1dfc11288e1 Mon Sep 17 00:00:00 2001
From: nd <git@notandy.de>
Date: Sun, 14 Jun 2020 13:07:11 +0200
Subject: [PATCH] added README.md

---
 README.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7696b03
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+# Files
+
+All configuration is to be placed inside the `filaes` dict.
+This dict is a <key>:<value> mapping. With <key> being the path of a file, for example
+'/boo/bar'. <value> is a *fileconfig* dict, see below.
+
+**fileonfig**
+```
+# file owner
+owner: root
+
+# file group
+group: root
+
+# permission bits, can be octal number or the string representation
+mode: 0700
+
+# can be 'present', 'absent', 'directory', or 'touch' (ensure file is created and set modification time to now, but do not change the content)
+state:  present
+
+# set the file content, mutaly exclusive with "template". Only handeled if the state if 'file'
+content: ''
+
+# not yet implemented
+template: ~
+template_vars: ~
+
+```
-- 
GitLab