Improve the README file

Based on the template at http://write-the-docs.readthedocs.org/en/latest/writing/beginners-guide-to-docs/