DOC: Fix pandas.Series.resample docstring
- [x] closes #22894
- [x] tests added / passed: 
  - [x] `./scripts/validate_docstrings.py pandas.Series.resample`
  - [x] `flake8 --doctests pandas/core/generic.py`
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry --> Needed?

- Followed pandas docstring [conventions](https://pandas.pydata.org/pandas-docs/stable/contributing_docstring.html) and general reST.
- Added deprecation directive on some parameters. Had some doubts but after investigation the recommended API changed after v0.18.0 for these parameters.

Please let me know if I can further improve this.

Thanks!