diff --git a/roles/redirects/defaults/main.yml b/roles/redirects/defaults/main.yml
index 730da1bcc51d9afb03bd3f9ab6a331117c411ba0..3a67115b9549b0cc00934a6644bdba035fad235e 100644
--- a/roles/redirects/defaults/main.yml
+++ b/roles/redirects/defaults/main.yml
@@ -1,3 +1,8 @@
+# Every entry creates a redirect listening on port 80 and 443 with the following parameters:
+#   - domain: the domain to listen on
+#   - to: the redirect target as defined by the nginx return statement
+#   - type: HTTP status code to use (302 = temporary redirect, 301 = permanent redirect
+#)
 redirects:
   - static.conf:
     domain: static.conf.archlinux.org