cleaning up index.rst file

Removed notes about the generation of the file and fixed the syntax.

Change-Id: I43b14602a36857de3fd278eaf8bdcf0f6c447587