DOC: update doc-string in Index.rename
updated doc-strings with examples 
- [x] closes #20787
- N/A tests added / passed
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- N/A whatsnew entry
