Skip to content

Add links to examples from the docstrings and user guides #26927

@adrinjalali

Description

@adrinjalali

We have a rich set of examples covering a very broad range of issues, but they're not necessarily easily discoverable via the section on the bottom of the API pages.

This meta-issue is to keep track of the examples for which we've already included links in the docs, and to fix the rest.

An example of how to include links to examples in API docs and the user guide can be found here: #26926 . Please see how it can be done before claiming an example.

For each example, please check if it's already included in the docs, either user guides or API docs, and if not, claim it by leaving a comment at the bottom of this issue and open a pull request for it. You can open one PR for more than one example if they're very related.

Note that not all examples need to be included in this project. For instance, if an example is only a usage example, and putting a link to it doesn't add much for the users, then we can ignore it (please do leave a comment if this is your finding). Also, not all examples are in a good shape, and in your PR you can also improve the example itself.

How to create a link to an example?
To create a link to the example examples/developing_estimators/sklearn_is_fitted.py, you can write:

:ref:`sphx_glr_auto_examples_developing_estimators_sklearn_is_fitted.py`

which would automatically create the link. Notice the pattern where slashes (/) are converted to an underscore (_) and the sphx_glr_auto_ prefix.

IMPORTANT: Please limit your pull requests to a limited scope, single or two classes, or a single example so that it can be reviewed easily.

Here's a list of all examples:

Metadata

Metadata

Labels

DocumentationMeta-issueGeneral issue associated to an identified list of tasksSprintgood first issueEasy with clear instructions to resolve

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions