Including the main README

The current main doc page is pretty bare. Including the README.rst is a trick I often use to:

- get a good intro for the main doc page

- make sure the readme is clear and small without cruft
Merge pull request #1 from reinout/patch-1

Including the main README