Adding more documentation for upsampling with replacement and error m…
…essage in case replacement is set to False

- [X] closes #27451
- [x] tests added / passed
- [X] passes `black pandas`
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [x] whatsnew entry
