diff --git a/README.rst b/README.rst
index 5cbc118..f078f3c 100644
--- a/README.rst
+++ b/README.rst
@@ -355,7 +355,7 @@ with - as well as a consumption argument.
 Constructing Legacy Client objects
 ----------------------------------
 
-If all you want to do is get a Client object from a python-*client library,
+If all you want to do is get a Client object from a python-\*client library,
 and you want it to do all the normal things related to clouds.yaml, `OS_`
 environment variables, a helper function is provided. The following
 will get you a fully configured `novaclient` instance.
diff --git a/tox.ini b/tox.ini
index 7a2d3a0..95dff6b 100644
--- a/tox.ini
+++ b/tox.ini
@@ -21,7 +21,12 @@ commands = {posargs}
 commands = python setup.py test --coverage --coverage-package-name=os_client_config --testr-args='{posargs}'
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+deps =
+    {[testenv]deps}
+    readme
+commands =
+    python setup.py build_sphinx
+    python setup.py check -r -s
 
 [flake8]
 # H803 skipped on purpose per list discussion.