README.rst: Add more information about documentation

Signed-off-by: Lucas Meneghel Rodrigues <lmr@redhat.com>
Merge pull request #1702 from autotest/more-readme-updates

README.rst: Add more information about documentation