Clean up typing and docs for indexing

[normanrz]

#1917 ported all indexing variants from the v2 codebase to v3. However, the typing is a mess and the docs are missing. This needs to be addressed before the 3.0 release.