DOC: added examples to align function's documentation
- [ ] closes #42125
- [ ] tests added / passed
- [ ] Ensure all linting tests pass, see [here](https://pandas.pydata.org/pandas-docs/dev/development/contributing.html#code-standards) for how to run them
- [ ] whatsnew entry

Hello @meiruv! Thanks for updating this PR. We checked the lines you've touched for [PEP 8](https://www.python.org/dev/peps/pep-0008) issues, and found:

* In the file [`pandas/core/generic.py`](https://github.com/pandas-dev/pandas/blob/7116772be261cf7eb117e64b3dd3abd87e25fe46/pandas/core/generic.py):

> [Line 8547:1](https://github.com/pandas-dev/pandas/blob/7116772be261cf7eb117e64b3dd3abd87e25fe46/pandas/core/generic.py#L8547): [W293](https://duckduckgo.com/?q=pep8%20W293) blank line contains whitespace



##### Comment last updated at 2021-07-13 11:54:34 UTC Hey @meiruv - are you still working on this? No hurry, just checking if it's still active / if you need help with anything This pull request is stale because it has been open for thirty days with no activity. Please update or respond to this comment if you're still interested in working on this. Hi @meiruv - still working on this? Looks like it's pretty close - no hurry if you are, would just be good to know closing as per https://github.com/pandas-dev/pandas/issues/42125#issuecomment-901025821