I checked with restview --long --pypi and the long description still
renders nicely, as do the pages created by sphinx

I thought the use of .. include:: would make README.rst still render
with all its contents, but sadly github doesn't enable
that (https://github.com/github/markup/issues/172)