DOC: Fixed documentation for few files
- [x] tests added / passed
- [x] Ensure all linting tests pass, see [here](https://pandas.pydata.org/pandas-docs/dev/development/contributing.html#code-standards) for how to run them

dont' we have a master issue for this? (e.g. getting all doc-tests running)? cc @MarcoGorelli  > dont' we have a master issue for this? (e.g. getting all doc-tests running)? cc @MarcoGorelli

I wasn't aware that not all doctests were running - anyway, there's #22459 still open small comment, otherwise lgtm lgtm @phofl over to you thanks @ShaharNaveh 