diff --git a/README.md b/README.md
index 3be1e5f..1dd7d70 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,20 @@
 
 Ansible libraries for manging Gandi resources.
 
+## Usage
+
+Include an entry in your `requirements.yml` like so.
+
+```yaml
+- src: https://git.autonomic.zone/autonomic-cooperative/autonomic.gandi
+  version: 0.0.1
+  name: autonomic.gandi
+```
+
+See the [releases](https://git.autonomic.zone/autonomic-cooperative/autonomic.gandi/releases) for which is the latest version.
+
+Then make sure to download the role with `ansible-galaxy install -r requirements.yml`.
+
 ## Roadmap
 
 - [ ] DNS entries