diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fe6711e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# ansible-role-touch-file
+ansible role to periodically touch a file. this is useful in monitoring, for example if you'd like to check if a certain file gets synchronized.
+
+
+~~~
+    - role: touch-file,
+      file: '/path/to/the/file-to-be-touched'
+~~~
\ No newline at end of file