CLN 31942/replace appender with doc 3
- [x] ref #31942
- [x] tests added / passed
- [x] passes `black pandas`
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [x] replaces `Appender` decorator with `doc`

Hello @smartvinnetou! 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:



















There are currently no PEP 8 issues detected in this Pull Request. Cheers! :beers: 

##### Comment last updated at 2020-06-14 20:34:47 UTC Can someone help with reviewing and merging this PR? Looks like some merge conflicts in - can you fix that up? > Looks like some merge conflicts in - can you fix that up?

done > @smartvinnetou for future reference would be nice if you can make smaller PRs. Something with this many changes is much harder to review at once, so typically better to have multiple PRs with smaller changes.

@WillAyd I appreciate that. That's why I stopped making more changes. I started other branches but soon found that there was a non trivial overhead on maintaining them and keeping them current. I hit a pause button until PRs start to be merged. @smartvinnetou can you please resolve the conflicts?

As said, smaller PRs are faster to review, get merged faster, and conflicts are less likely. > As said, smaller PRs are faster to review, get merged faster, and conflicts are less likely.

@datapythonista, point taken. Will keep future PRs smaller.

Conflicts are now reslved. @smartvinnetou pls merge master again.

@jorisvandenbossche @TomAugspurger @datapythonista can you give a quick look again and merge if good. > @smartvinnetou pls merge master again.

Conflict resolved.

> 
> @jorisvandenbossche @TomAugspurger @datapythonista can you give a quick look again and merge if good.
 Thanks @smartvinnetou, very nice clean up.

Once the development documentation is updated, can you please have a quick look at the updated pages, and see if everything is rendering as expected.

Thanks! > Thanks @smartvinnetou, very nice clean up.
> 
> Once the development documentation is updated, can you please have a quick look at the updated pages, and see if everything is rendering as expected.
> 
> Thanks!

@datapythonista, where do I find this documentation?
 https://pandas.pydata.org/docs/dev/