Update README.rst.

- Add a note about the RTFD link
- Sync with docs/index.rst
- Fix the automodule usage in README.rst.