Update README.rst.

- Add a note about the RTFD link
- Sync with docs/index.rst
- Fix the automodule usage in README.rst.
Fix a typo.
Merge pull request #37 from berkerpeksag/readme-update

Readme update