Convert README.md to README.rst

Break the content out into a number of smaller files. This makes
it easier to adopt to sphinx docs.
Include content from README in index.rst

remove the old temporary api file.