README.rst: rearrange so that it does not include sphinx directives
Sphinx directives are not accepted as descriptions on PyPI, so we should remove
them from README. To that end, refactor README as a doc fragmented which is
linked from root dir (pointing to docs/README.rst) and included into
docs/index.rst.