Add notes on how to cut a release.

Author: hardbyte

doc/overview.rst renamed to doc/development.rst

@@ -1,10 +1,27 @@
 Developer's Overview
 ====================
 
-Explore the source code on bitbucket:
+
+Contributing
+------------
+
+Contribute to source code, documentation, examples and report issues on bitbucket:
 https://bitbucket.org/hardbyte/python-can
 
 
+Creating a Release
+------------------
+
+- Release from the ``default`` branch.
+- Update the library version in ``setup.py`` and in ``doc/conf.py`` using
+`semantic versioning <http://semver.org>`__.
+- Run all tests and examples against available hardware.
+- Update `CONTRIBUTORS.txt` with any new contributors.
+- Sanity check that documentation has stayed inline with code. For large changes update ``doc/history.rst``
+- Create a temporary virtual environment. Run ``python setup.py install`` and ``python setup.py test``
+- Create and upload the distribution: ``python setup.py sdist bdist_wheel upload --sign``
+- In a new virtual env check that the package can be installed with pip: ``pip install python-can``
+
 Code Structure
 --------------
 

doc/index.rst

@@ -45,7 +45,7 @@ Contents:
    interfaces
    protocols
    bin
-   overview
+   development
    history