diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3d48790
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+Examples
+========
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+roles:
+    - { role: etckeeper,                    tags: ['system', 'etckeeper']}
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To avoid `etckeeper` autocommits (daily or before package manager runs) set
+`avoid_autocommits` to `true`:
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+roles:
+    - { role: etckeeper,                    tags: ['system', 'etckeeper'],
+        avoid_autocommits: true }
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~