CLN: update Appender to doc decorator with case __doc__
- [x] working for #31942
- [x] tests added / passed
- [x] passes `black pandas`
- [x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [x] whatsnew entry

Thanks @HH-MWB 