Documentation improvement for TaylorDiagram class and set_titles_and_labels

[jukent]

PR Summary

Closes #176 and #212

PR Checklist

General

• Make an issue if one doesn't already exist
• Link the issue this PR resolves by adding closes #XXX to the PR description where XXX is the number of the issue.
• Add a brief summary of changes to docs/release-notes.rst in a relevant section for the next unreleased release. Possible sections include: Documentation, New Features, Bug Fixes, Internal Changes, Breaking Changes/Deprecated
• Add appropriate labels to this PR
• Make your changes in a forked repository rather than directly in this repo
• Open this PR as a draft if it is not ready for review
• Convert this PR from a draft to a full PR before requesting reviewers
• Passes precommit. To set up on your local, run pre-commit install from the top level of the repository. To manually run pre-commits, use pre-commit run --all-files and re-add any changed files before committing again and pushing.

Documentation

• Docstrings have been added to all new functions
• Docstrings have been updated with any function changes
• Internal functions have a preceding underscore (_) and have been added to docs/internal_api/index.rst
• User facing functions have been added to docs/user_api/index.rst under their module

Examples

• Any new notebook examples added to docs/examples/ folder
• Clear all notebook cells
• New notebook files added to docs/examples.rst toctree
• New notebook files added to new entry in docs/gallery.yml with appropriate thumbnail photo in docs/_static/thumbnails/

[kafitzgerald]

Agree this makes more sense.

A few typos and suggestions mentioned in the comments, but mostly wanted to raise a few questions about terminology (while we're making painful changes).

I wonder if we want to add some sort of deprecation warnings as well. Thoughts?

[kafitzgerald]

I might have spaced this before (apologies if so), but we should probably add either deprecation warnings or pending deprecation warnings and something in a deprecations section of the release notes about the renamed methods.

Otherwise, looks good.

[jukent]

I might have spaced this before (apologies if so), but we should probably add either deprecation warnings or pending deprecation warnings and something in a deprecations section of the release notes about the renamed methods.

Otherwise, looks good.

Thanks @kafitzgerald just added them!

[kafitzgerald]

Suggested change

	'This function is deprecated. Call `add_std_grid` instead.',
	'`TaylorDiagram.add_ygrid` will be deprecated in the future. Please use `TaylorDiagram.add_std_grid` instead.',

[kafitzgerald]

Suggested change

	'This function is deprecated. Call `add_corr_grid` instead.',
	'`TaylorDiagram.add_xgrid` will be deprecated in the future. Please use `TaylorDiagram.add_corr_grid` instead.',

[kafitzgerald]

Suggested change

	This function will be deprecated in favor of `add_corr_grid()`
	This method will be deprecated in favor of `TaylorDiagram.add_corr_grid`

[kafitzgerald]

Suggested change

	This function will be deprecated in favor of `add_std_grid()`
	This method will be deprecated in favor of `TaylorDiagram.add_std_grid`.