Cleaning up index.rst file

Removed notes about the generation of the file and fixed the syntax.
Merge pull request #1 from berendt/fix_doc_index

Cleaning up index.rst file