DOC: Updating DataFrame.join docstring
- [X] closes #22897
- [ ] tests added / passed
- [ ] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

Original work from @JustinZhengBC in #22904. The remote branch does not exist anymore, and I need to create this new PR to rebase.

Merging on green.