DOC: Small docstring clarifications
- [X] All [code checks passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#pre-commit).


Some small changes to docstrings that were hard to interpret when typing in pandas-stubs.

xref pandas-dev/pandas-stubs#352
Thanks @bashtage 