Add CONTRIBUTING.rst and move documentation

In order to have a nice separation between documentation for users of
the library and contributors.
Merge pull request #6 from mhogerheijde/feature/contributing

Add CONTRIBUTING.rst and move documentation