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.
Merge pull request #301 from jcrobak/readme-md-rst-sphinx

Convert README.md to ReST and divide into several pages for sphinx