lots of index toctree corrections and links within the docs corrected