DOC: PR08 doctring validation
- [x] closes #25232
- [x] 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


CI failures unrelated