DOC: Improve docs for plotting
- [X] All [code checks passed](https://pandas.pydata.org/pandas-docs/dev/development/contributing_codebase.html#pre-commit).


Some doc issues found when adding typing to pandas-stubs
Thanks @bashtage 