Thanks to visit codestin.com
Credit goes to github.com

Skip to content

DOC Ensures that fetch_rcv1 passes numpydoc validation #22225

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.

Sign up for GitHub

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

Jump to bottom
Merged
merged 4 commits into from
Jan 23, 2022
Merged

DOC Ensures that fetch_rcv1 passes numpydoc validation #22225

merged 4 commits into from
Jan 23, 2022

Conversation

SamAdamDay
Copy link
Contributor

Reference Issues/PRs

Addresses #21350

What does this implement/fix? Explain your changes.

Ensured that datasets._rcv1.fetch_rcv1 passes numpydoc validation.

  • Removed the function from the list FUNCTION_DOCSTRING_IGNORE_LIST.
  • Made sure that the second return value has a description.
  • Added sentence to each return value stating under which condition it is returned.
  • Changed the type description for (data, target) to tuple from tuple if ``return_X_y`` is True. It doesn't seem that the type of this return value depends on the value of return_X_y. Instead, whether or not such a return value exists depends on this.

Any other comments?

The type description tuple if ``return_X_y`` is True appears in several other function docstrings.

thomasjpfan
thomasjpfan approved these changes Jan 15, 2022
View reviewed changes
Copy link
Member

@thomasjpfan thomasjpfan left a comment

Choose a reason for hiding this comment

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

Thank you for the PR @SparklePigBang !

LGTM!

@thomasjpfan thomasjpfan added the Quick Review For PRs that are quick to review label Jan 15, 2022
@thomasjpfan thomasjpfan mentioned this pull request Jan 17, 2022
Closed
jjerphan
jjerphan approved these changes Jan 18, 2022
View reviewed changes
Copy link
Member

@jjerphan jjerphan left a comment

Choose a reason for hiding this comment

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

LGTM.

@jjerphan jjerphan removed the Quick Review For PRs that are quick to review label Jan 18, 2022
@jmloyola
Copy link
Member

Thanks for the PR @SparklePigBang 😃
LGTM!

I left a comment with something that I believe would improve the documentation. Let me know what you think.

@SamAdamDay
Copy link
Contributor Author

I left a comment with something that I believe would improve the documentation. Let me know what you think.

Thank you for the suggestion. It looks good to me. My only concern is that I haven't been able to find another docstring where the return attributes are itemised in this way. Would this be a problem?

@jmloyola
Copy link
Member

That's true, I think there is no other returned dictionary documented this way.

What do you think @thomasjpfan @jjerphan?
Should we leave as it is or should we add the items? I think it looks better with the items, but we may need to adapt other returns dictionary (or Bunchs) to mantain consistency in the future.

jmloyola
jmloyola reviewed Jan 21, 2022
View reviewed changes
sklearn/datasets/_rcv1.py Outdated
@@ -136,8 +136,8 @@ def fetch_rcv1(
Returns
-------
dataset : :class:`~sklearn.utils.Bunch`
Dictionary-like object. Returned only if `return_X_y` is False. Has
the following attributes.
Dictionary-like object. Returned only if `return_X_y` is False.
Copy link
Member

Choose a reason for hiding this comment

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

There is a failing test related to black because there is a trailing white space in this line.

@jjerphan
Copy link
Member

That's true, I think there is no other returned dictionary documented this way.

What do you think @thomasjpfan @jjerphan? Should we leave as it is or should we add the items? I think it looks better with the items, but we may need to adapt other returns dictionary (or Bunchs) to mantain consistency in the future.

This looks better to me with this new comment. Let's merge after having the linting fixed.

@thomasjpfan thomasjpfan changed the title DOC Ensures that datasets._rcv1.fetch_rcv1 passes numpydoc validation DOC Ensures that fetch_rcv1 passes numpydoc validation Jan 23, 2022
@thomasjpfan thomasjpfan merged commit cdf0d69 into scikit-learn:main Jan 23, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@jmloyola jmloyola jmloyola left review comments

@thomasjpfan thomasjpfan thomasjpfan approved these changes

@jjerphan jjerphan jjerphan approved these changes

Assignees
No one assigned
Labels
Documentation module:datasets No Changelog Needed
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
4 participants
@SamAdamDay @jmloyola @jjerphan @thomasjpfan