DOC: Document and annotate Index.reindex (#40328).
- [x] closes #40328 
- [x] Ensure all linting tests pass, see [here](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#pre-commit) for how to run them



thanks @ShivnarenSrinivasan 