index: a few tweaks

Fixing up JSDocs, keeping things a bit tidier.