Skip to content

DOC add link to plot_covariance_estimation example in docstrings and userguide #30429

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

Merged
merged 12 commits into from
Jan 2, 2025

Conversation

stefanogaspari
Copy link
Contributor

Reference Issues/PRs

PR #26927

What does this implement/fix? Explain your changes.

Added links to plot_covariance_estimation example in docstrings and userguide

Copy link

github-actions bot commented Dec 8, 2024

✔️ Linting Passed

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

Generated for commit: 939ae7c. Link to the linter CI: here

Copy link
Contributor

@StefanieSenger StefanieSenger left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @stefanogaspari,

thanks for your PR. I have added a few remarks.

In general, I think the example should only be mentioned in the docstrings of OAS and LedoitWolf, as their regularization is the topic of the example; and GridSearchCV is only used the measure their performance.

@stefanogaspari
Copy link
Contributor Author

Hi @StefanieSenger ,
thank you very much for your feedback!
I proceed with the adjustments right away.

stefanogaspari and others added 3 commits December 9, 2024 22:35
References scikit-learn#26927

What does this fix?
Added links to plot_covariance_estimation example in docstrings and userguide
@StefanieSenger
Copy link
Contributor

Thank you, @stefanogaspari, that looks very good.

Please go ahead removing the mention of the example in the EmpiricalCovariance part of the Userguide, as you suggested, and then we're all set and I can recommend this PR to be merged. :)

@stefanogaspari
Copy link
Contributor Author

stefanogaspari commented Dec 10, 2024

Thank you, @stefanogaspari, that looks very good.

Please go ahead removing the mention of the example in the EmpiricalCovariance part of the Userguide, as you suggested, and then we're all set and I can recommend this PR to be merged. :)

Hi @StefanieSenger , good afternoon
I already did it : )
Thanks a lot for your help!

@StefanieSenger
Copy link
Contributor

I already did it : )

Oh yes, now I see. And you also need to fix the doctest issues shown in the CI.
I think removing the .. rubric:: Examples when no examples follow, will do.

@StefanieSenger
Copy link
Contributor

Some general information: when you go into the CI checks overview below, you find one that says "Check the rendered docs here!". In there, you can look into how the CI build the documentation for the changed files.

For instance: modules/generated/sklearn.covariance.OAS.html [dev, stable]
(Future reference: these links will stop working after a few days or weeks, but it's just an example anyways.)

Where the first link is your branches version, the second is the main dev branch and the third link is the last releases scikit-learn version you can find on the website.

It helps to check if everything went well.

@stefanogaspari
Copy link
Contributor Author

@StefanieSenger , all the checks have passed :)
Thank you again for your support!

@StefanieSenger
Copy link
Contributor

That looks pretty good! Thanks again for your contribution! 🥇

@adrinjalali, can we merge this one?

@stefanogaspari
Copy link
Contributor Author

That looks pretty good! Thanks again for your contribution! 🥇

@adrinjalali, can we merge this one?

Hello @adrinjalali,

@StefanieSenger has approved this PR. Could you kindly merge it when possible?

I’m currently working on another example for the Covariance chapter, and merging this would help me avoid potential conflicts.

Thanks a lot!

@stefanogaspari
Copy link
Contributor Author

@adrinjalali I just pushed your suggested changes.
Thanks for your help.

@adrinjalali adrinjalali merged commit 99d5cd0 into scikit-learn:main Jan 2, 2025
30 checks passed
@stefanogaspari stefanogaspari deleted the plot_covariance branch January 2, 2025 17:23
jeremiedbb pushed a commit to jeremiedbb/scikit-learn that referenced this pull request Jan 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants