Add comment about proxy env pass through

For users in a proxy environment, checking the doc urls requires being
able to pass through the proxy environment variables. Include a simple
comment along with the tox command requiring it to help users checking
any links added are valid.

Add some references to documentation, both in the detailed
documentation and the quick README.rst that would be more commonly
checked.

Change-Id: I2316bc1b7e845c29a8b248eef4668a6099d109f7

1 files changed, 15 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index bb280c89..298f5a68 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
 ---------------------------