CLN 31942/replace appender with doc 3

[smartvinnetou]

• ref CLN: Update docstring decorator from Appender and Substitution to doc #31942
• tests added / passed
• passes black pandas
• passes git diff upstream/master -u -- "*.py" | flake8 --diff
• replaces Appender decorator with doc

[pep8speaks]

Hello @smartvinnetou! Thanks for updating this PR. We checked the lines you've touched for PEP 8 issues, and found:

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

Comment last updated at 2020-06-14 20:34:47 UTC

[smartvinnetou]

Can someone help with reviewing and merging this PR?

[WillAyd]

Looks like some merge conflicts in - can you fix that up?

[smartvinnetou]

Looks like some merge conflicts in - can you fix that up?

done

[WillAyd]

@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.

That said this lgtm - @datapythonista care to look?

[smartvinnetou]

@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.

[datapythonista]

@smartvinnetou can you please resolve the conflicts?

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

[smartvinnetou]

@smartvinnetou pls merge master again.

Conflict resolved.

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

[datapythonista]

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!

[smartvinnetou]

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?

[datapythonista]

https://pandas.pydata.org/docs/dev/