Merge pull request #1 from pramttl/develop

Small corrections in docs.
Add indices and tables
Added docs explaining the repository structure and top level directories.