diff --git a/README.md b/README.md
index c2536e86da04624c34c57134fff612aec916a21a..d5189ba9e2e9edee0566d9cf20d91e5d632516c5 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
 # mdx-saas-config
 
-Configuration repository for MDX as a service pilot
\ No newline at end of file
+Configuration repository for MDX as a service pilot
+
+## Configuration
+```inventory/inventory```
+
+  * contains all the machines alt-mdx should be deployed to grouped by function
+
+```inventory/group_vars/all.yml```
+
+  * contains the tlds and dns/server/proxy configuration for those machines
+
+```files/[tld].yaml```
+
+  * contains the GeoDNS configuration as a yaml file.