Add inline documentation for `selectorForSlice`

[dpikt]

Old docs can be found in legacy-docs.md. Remember to delete the relevant section once it's been added to the auto-generated docs.