document how to change docstrings when deprecating params

[drammock]

Proposed documentation enhancement

we should update https://mne.tools/dev/development/contributing.html#deprecate-with-a-decorator-or-a-warning to have a docstring in the example function, that shows how to use our sphinx roles etc within the param descriptions.