docs.index: added introduction paragraph; added contents to toctree; cleaned up comments.