Updated README

[jturnbull]

Added better description.

@meshy please review

[jturnbull]

@meshy reverted my master commits

[meshy]

@jturnbull there two other commits that did not get reverted by the looks of it.

[meshy]

...and it would have been better to PR the fix for setup.py, rather than push the revert commit to master

[jturnbull]

@meshy all three commits were reverted, despite the comment.

...and it would have been better to PR the fix for setup.py, rather than push the revert commit to master

Why? This way you can review all the changes in one place

[meshy]

Why?

So that the code change can be reviewed. There was no need to add a revert. The change was fundamentally sound, but it introduced a bug. Better to fix the bug.

[LilyFoote]

I thought PyPI doesn't support markdown?

[meshy]

Also, if you revert more than one commit together in a bunch again, please add the commit hashes to the commit message.

[meshy]

@Ian-Foote it doesn't.

[LilyFoote]

Do we want to drop the long_description, or should we continue to use rst? Or is there another solution?

[meshy]

I think we should continue to provide a markdown long description.

[codecov-io]

Current Coverage via 24cca87 is 68.91%

Merging readmeupdates into master will change coverage by -1.68%

@@            master   readmeupdates   diff @@
==============================================
  Files            2               2       
  Stmts          119             119       
  Branches         0               0       
==============================================
- Hit             84              82     -2
  Partial          0               0       
- Missed          35              37     +2

[jturnbull]

@meshy should I try to up the coverage in this PR? ;)

[meshy]

Haha! I think we can let that one slip ;)