diff --git a/roles/configure-mirrors/README.rst b/roles/configure-mirrors/README.rst
index 4edab2e7a..6c5b25fdd 100644
--- a/roles/configure-mirrors/README.rst
+++ b/roles/configure-mirrors/README.rst
@@ -1 +1,13 @@
-An ansible role to configure mirrors for common services
+An ansible role to configure services to use mirrors.
+
+Role Variables
+
+mirror_host
+  The base host for mirror servers
+
+mirror_domain
+  Domain of the mirror. Use in pydistutils to allow find-links arguments to
+  be used if they point at this domain.
+
+pypi_mirror
+  URL to override the generated pypi mirror url based on mirror_host
diff --git a/roles/configure-mirrors/defaults/main.yaml b/roles/configure-mirrors/defaults/main.yaml
index 9a49f11e8..9594be66d 100644
--- a/roles/configure-mirrors/defaults/main.yaml
+++ b/roles/configure-mirrors/defaults/main.yaml
@@ -1,2 +1 @@
-mirror_host: mirror.example.org
 pypi_mirror: "http://{{ mirror_host }}/pypi/simple"