diff --git a/README.md b/README.md
new file mode 100644
index 0000000..538163c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# Doku2Dot
+
+Macht aus den "Ansible host_vars" ein Diagramm. Nur nützlich zusammen mit den "Ansible host_vars"
+
+## Dependencies
+
+* `rust` with `curl -sSf https://static.rust-lang.org/rustup.sh | sh`
+* `graphviz`
+
+## Usage
+
+cargo run ../ansible/host_vars/* | dot -T png > diagramm.png 
+
+## Example output
+
+![example](diagramm.png)