diff --git a/README.rst b/README.rst
index 124c6cb..b5a82a3 100644
--- a/README.rst
+++ b/README.rst
@@ -35,19 +35,10 @@ creating DIBs.
 Role Variables
 --------------
 
-.. code-block:: yaml
 
-    # Name of the user to be created.
-    # Default: nodepool
-    nodepool_user_name: nodepool
-
-    # Name of the group to be created.
-    # Default: nodepool
-    nodepool_user_group: nodepool
-
-    # Path of home directory to be created.
-    # Default: /var/lib/nodepool
-    nodepool_user_home: /var/lib/nodepool
+.. literalinclude:: ../../defaults/main.yaml
+   :language: yaml
+   :start-after: under the License.
 
 Dependencies
 ------------
diff --git a/doc/requirements.txt b/doc/requirements.txt
new file mode 100644
index 0000000..1f3277f
--- /dev/null
+++ b/doc/requirements.txt
@@ -0,0 +1,7 @@
+# The order of packages is significant, because pip processes them in the order
+# of appearance. Changing the order has an impact on the overall integration
+# process, which may cause wedges in the gate later.
+
+# this is required for the docs build jobs
+sphinx!=1.6.6,!=1.6.7,>=1.6.2 # BSD
+doc8>=0.6.0 # Apache-2.0
diff --git a/test-requirements.txt b/test-requirements.txt
index 9ea7158..4c4414f 100644
--- a/test-requirements.txt
+++ b/test-requirements.txt
@@ -1,3 +1,2 @@
 ansible-lint
 hacking<0.11,>=0.10
-sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.3
diff --git a/tox.ini b/tox.ini
index e56c12f..e4ba5ba 100644
--- a/tox.ini
+++ b/tox.ini
@@ -19,7 +19,13 @@ setenv =
   PYTHONUNBUFFERED = 1
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+deps = -r{toxinidir}/doc/requirements.txt
+whitelist_externals =
+  bash
+commands=
+  bash -c "rm -rf doc/build"
+  doc8 doc
+  sphinx-build -b html doc/source doc/build/html
 
 [testenv:venv]
 commands = {posargs}