fix up index to have a bit more information, plus some places to hang new documentation