Update README.rst and CHANGES. Close #2.

Author: RKrahl

CHANGES

@@ -5,6 +5,8 @@
 
 ** New features
 
+ + Issue #2: Add documentation.
+
  + Issue #4: Add a depend() function to add a dependency to a test at
    runtime.
 

README.rst

@@ -1,9 +1,3 @@
-.. note:: This is the ``documentation`` branch of the code.
-          Its purpose is to write documentation and to solve Issue `#2`__.
-
-.. __: https://github.com/RKrahl/pytest-dependency/issues/2
-
-
 pytest-dependency - Manage dependencies of tests
 ================================================
 
@@ -60,6 +54,19 @@ It removes the use of certain language features (dict comprehensions)
 that were introduced in Python 2.7.
 
 
+Documentation
+-------------
+
+The directory doc/html in the source distribution contains the
+documentation in HTML form generated by Sphinx.  The starting point is
+doc/html/index.html.  The documentation can also be found online at
+
+    http://pythonhosted.org/pytest-dependency/
+
+The example test modules used in the documentation can be found in
+doc/examples in the source distribution.
+
+
 Bugs and limitations
 --------------------