Improve the README file

Based on the template at http://write-the-docs.readthedocs.org/en/latest/writing/beginners-guide-to-docs/
Merge pull request #68 from gdetrez/readme

Improve the README file