diff --git a/README.rst b/README.rst
index bb280c89a..298f5a681 100644
--- a/README.rst
+++ b/README.rst
@@ -69,6 +69,21 @@ This consistency will help users avoid simple mistakes when writing
 YAML, as well as developers when matching YAML components to Python
 implementation.
 
+Unit Tests
+----------
+
+Unit tests have been included and are in the ``tests`` folder. Many unit
+tests samples are included as examples in our documentation to ensure that
+examples are kept current with existing behaviour. To run the unit tests,
+execute the command::
+
+    tox -e py34,py27
+
+* Note: View ``tox.ini`` to run tests on other versions of Python,
+  generating the documentation and additionally for any special notes
+  on running the test to validate documentation external URLs from behind
+  proxies.
+
 Installing without setup.py
 ---------------------------
 
diff --git a/doc/source/installation.rst b/doc/source/installation.rst
index 9187451eb..ddd4a5b62 100644
--- a/doc/source/installation.rst
+++ b/doc/source/installation.rst
@@ -33,6 +33,15 @@ locally execute the command::
 The generated documentation is then available under
 ``doc/build/html/index.html``.
 
+As over time URLs change or become stale there is also a testenv available
+to verify any links added. To run locally execute the command::
+
+    tox -e docs-linkcheck
+
+* Note: When behind a proxy it is necessary to use ``TOX_TESTENV_PASSENV``
+  to pass any proxy settings for this test to be able to check links are
+  valid.
+
 Unit Tests
 ----------
 
diff --git a/tox.ini b/tox.ini
index e2924ffed..d8bcba376 100644
--- a/tox.ini
+++ b/tox.ini
@@ -39,6 +39,9 @@ commands = jenkins-jobs test -o .test/new/out/ .test/new/config/
 commands = python setup.py build_sphinx {posargs}
 
 [testenv:docs-linkcheck]
+# If you are behind a proxy, for this test to work you will need to set
+# TOX_TESTENV_PASSENV="http_proxy https_proxy no_proxy ..." to pass
+# through the proxy environment settings to be able to validate any urls.
 commands = python setup.py build_sphinx -b linkcheck
 
 [testenv:venv]