DOC add examples to two docstrings for calibration

[mingness]

Reference Issues/PRs

Contributes towards issue #26927

What does this implement/fix? Explain your changes.

Examples of calibration added to docstrings in sklearn/calibration.py

Any other comments?

[github-actions]

✔️ Linting Passed

All linting checks passed. Your pull request is in excellent shape! ☀️

_{Generated for commit: 09cb1b3. Link to the linter CI: here}

[betatim]

Thanks for working on this! This looks good, I'd just move where it is in the docstrings.

Lets see what happens to the CI run after you make those changes. I guess these aren't real failures so hopefully they will go away on the next re-run. Otherwise we need to investigate a bit.

[mingness]

I've moved the links to the examples as per the example you provided, many thanks.

[betatim]

I am not sure I understand why the docs build fails. The error is this:

/home/circleci/project/sklearn/calibration.py:docstring of sklearn.calibration.CalibrationDisplay:74: WARNING: Exception occurred in plotting sklearn-calibration-CalibrationDisplay-2
 from /home/circleci/project/doc/modules/generated/sklearn.calibration.CalibrationDisplay.rst:
Traceback (most recent call last):
  File "/home/circleci/mambaforge/envs/testenv/lib/python3.9/site-packages/matplotlib/sphinxext/plot_directive.py", line 472, in run_code
    exec(code, ns)
  File "<string>", line 2
    For another example of usage, see:
        ^
SyntaxError: invalid syntax

Which I think means that too much of the doc string is selected by matplotlib as code. However, when I build the docs locally this doesn't happen. @ogrisel do you have an idea where to start looking maybe?

[betatim]

This is the bit that is causing the error.

[ogrisel]

The plot_directive.py of that version of matplotlib probably has a bug and it might be necessary to debug or search for similar issues in the matplotlib issue tracker.