diff --git a/elements/fedora/README.rst b/elements/fedora/README.rst
index 4d3976901..e4be30cde 100644
--- a/elements/fedora/README.rst
+++ b/elements/fedora/README.rst
@@ -1,14 +1,19 @@
 ======
 fedora
 ======
-Use Fedora cloud images as the baseline for built disk images.
 
-If you wish to use a Fedora Yum mirror you can set DIB\_DISTRIBUTION\_MIRROR
-before running bin/disk-image-create. Example:
+Use Fedora cloud images as the baseline for built disk images. For further
+details see the redhat-common README.
 
-  DIB\_DISTRIBUTION\_MIRROR=http://download.fedoraproject.org/pub/fedora/linux
+Overrides:
+
+DIB_DISTRIBUTION_MIRROR:
+   :Required: No
+   :Default: None
+   :Description: To use a Fedora Yum mirror, set this variable to the mirror URL
+                 before running bin/disk-image-create. This URL should point to
+                 the directory containing the ``releases/updates/development``
+                 and ``extras`` directories.
+   :Example: ``DIB\_DISTRIBUTION\_MIRROR=http://download.fedoraproject.org/pub/fedora/linux``
 
-This URL should point to the directory containing the releases/updates/
-development/and extras directories.
 
-For further details see the redhat-common README.