Enhance project documentation in README

[pekkaklarck]

• Add real usage example
• More info about project history
• Supported Python versions
• Use by setup.py to get same content to PyPI (this was originally Better project introduction to PyPI #254)

[aaltat]

I think this was done by #877