Added note in docs for giving the developer the option of choosing be…
…tween both parameters and kwargs. Exampled included

- [ ] closes #xxxx
- [ ] tests added / passed
- [ ] 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
- [ ] whatsnew entry

thanks @Pydare  @meeseeksdev backport 1.4.x Something went wrong ... Please have a look at my logs. this closes #45258? yep