DOC: Updates Index.reindex docstrings (#40328)
- [x] closes #40328: explains function parameters and gives basic example
- [ ] tests added / passed
- [ ] Ensure all linting tests pass, see here for how to run them
- [ ] whatsnew entry