add comments to index doc
Merge pull request #1343 from dimagi/documenting_doc

Added comments for future reference to index.rst
Tiny change, only comments affected. self merging