-
-
Notifications
You must be signed in to change notification settings - Fork 25.8k
Add links to examples from the docstrings and user guides #26927
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Comments
PR #26904 (DOC Add links to pipelines examples in docstrings) takes care of examples/compose: plot_column_transformer_mixed_types.py |
PR #26877 (DOC Add links to preprocessing examples in docstrings and userguide) takes care of examples/preprocessing: plot_all_scaling.py |
PR DOC Add links to decomposition examples in docstrings and user guide adds examples/decomposition:
Other examples that are related to decomposition but found in different sections that were linked here: examples/applications:
examples/compose:
examples/release_highlights:
|
Working on PR: #26950
Related Example files: |
@Shreesha3112 please list files for which you're working on, and only focus on a single class for each PR. |
@adrinjalali Added Class and its related example files |
I'm working on plot_cyclical_feature_engineering |
I am working on plot_classification_probability |
I am working on plot_classifier_comparison.py |
I'm working on plot_iris_dataset.py |
Working on plot_classification.py |
working on plot_optics.py |
Worked on |
References scikit-learn#26927 What does this fix? Added links to plot_covariance_estimation example in docstrings and userguide
References scikit-learn#26927 What does this fix? Added links to plot_covariance_estimation example in docstrings and userguide
Worked on |
Working on |
Hi @mohsina-bilal, |
Working on examples/semi_supervised
|
Some links in your first post description are outdated because the examples do not exist in the repo anymore. Do you think it's helpful to edit the description so that newcomers do not go searching for them? You could still choose to still keep the ones which have associated merged pull requests for completeness. e.g., (1) In
files do not exist. (2) The If I find more non-existent files, I will add it in the comments. |
Thanks @ani0075saha , updated the list. |
Hi, i will be working on _examples/linear_model:_plot_lasso_and_elasticnet.py |
sorry about the closed pull requests had a problem with white spaces again ;) |
Working on |
Hi, I would like to work on Not sure if putting the example in 12. Choosing the right estimator of user guide would help users choosing a classifier. Any idea ? |
Hi @cbohnert67, that sounds like a great idea. 👍 Go for it. |
We are providing a new issue for keep track of the progress in this issue. See the new Add links to examples from the docstrings and user guide #30621. Please from now on, refer to the new issue. |
wow, thank you @StefanieSenger ❤️ |
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:which would automatically create the link. Notice the pattern where slashes (
/
) are converted to an underscore (_
) and thesphx_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:
examples/applications:
examples/bicluster:
SpectralBiclustering
#29311examples/calibration:
examples/classification:
examples/cluster:
init
usage in KMeans #26981plot_kmeans_stability_low_dim_dense.py
#30349examples/compose:
pipelines
examples in docstrings #26904pipelines
examples in docstrings #26904pipelines
examples in docstrings #26904pipelines
examples in docstrings #26904pipelines
examples in docstrings #26904pipelines
examples in docstrings #26904examples/covariance:
examples/cross_decomposition:
examples/datasets:
examples/decomposition:
examples/developing_estimators:
examples/ensemble:
examples/exercises:
examples/feature_selection:
examples/gaussian_process:
examples/impute:
examples/inspection:
examples/kernel_approximation:
examples/linear_model:
examples/manifold:
examples/miscellaneous:
examples/mixture:
examples/model_selection:
examples/multioutput:
examples/neighbors:
examples/neural_networks:
examples/preprocessing:
examples/semi_supervised:
examples/svm:
- [ ] DOC Adds Links to plot_svm_scale_c.py Example #28830
examples/text:
examples/tree:
The text was updated successfully, but these errors were encountered: