Skip to content

[WIP]Improve permutation_test_score docstring #10931

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

Closed
wants to merge 3 commits into from

Conversation

maskani-moh
Copy link
Contributor

Reference Issues/PRs

Fixes #10905

What does this implement/fix? Explain your changes.

Improves the docstring of permutation_test_score and modifies change log section in whats_new module

Copy link
Contributor Author

@maskani-moh maskani-moh left a comment

Choose a reason for hiding this comment

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

How can I deal with Change Log retrospectively?

@@ -787,6 +787,8 @@ Changelog

- :ref:`olivetti_faces` by `David Warde-Farley`_.

- :func:`model_selection.model_selection.permutation_test_score` by `Alexandre Gramfort`_.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@amueller
How can I deal with modifying the changelog retrospectively? 🤔
The original function has been added to scikits.learn.cross_val.py module. How do I need to refer to it now?

Copy link
Member

Choose a reason for hiding this comment

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

Adding it to an old whatsnew is not usually something we do. You can do a "versionadded" if you want (thought it would be the earliest whatsnew in the code base for sure). We don't really guarantee completeness of the changelog.

@maskani-moh maskani-moh changed the title Fix 10905 [WIP]Improve permutation_test_score docstring Apr 6, 2018
@@ -877,7 +879,7 @@ People
- 127 `Jake Vanderplas`_
- 120 `Mathieu Blondel`_
- 85 `Alexandre Passos`_
- 67 `Alexandre Gramfort`_
- 68 `Alexandre Gramfort`_
Copy link
Member

Choose a reason for hiding this comment

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

that's not what that counts ;) I suggest just leaving this file alone, I was just complaining.

Copy link
Member

Choose a reason for hiding this comment

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

Can you undo this and the changelog fix please?

@amueller
Copy link
Member

amueller commented Apr 6, 2018

The main complaint was that there is no mention in the user guide, i.e. here:
http://scikit-learn.org/dev/modules/cross_validation.html#cross-validation

The link in the docstring here should link to a portion to the user guide explaining what the function is for:
http://scikit-learn.org/dev/modules/generated/sklearn.model_selection.permutation_test_score.html#sklearn.model_selection.permutation_test_score

@maskani-moh
Copy link
Contributor Author

Oh my bad 🤕
I am taking care of that then! Thanks!

@thomasjpfan
Copy link
Member

Closing since the original issue was fixed in #17373

@thomasjpfan thomasjpfan closed this Feb 2, 2022
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.

permutation_test_score has no user guide
3 participants