diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b5f5164
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Ansible Role: Drupal settings
+
+```yaml
+drupal_settings:
+  - drupal_root: /var/www/web
+    sites:
+      - name: default
+        filename: settings.php # Optional, defaults to 'settings.php'
+        settings:
+          databases:
+            foo:
+              bar:
+                driver: mysql # Optional, defaults to 'mysql'
+                host: localhost # Optional, defaults to 'localhost'
+                database: mydatabase
+                username: user
+                password: secret
+```