-
-
Notifications
You must be signed in to change notification settings - Fork 25.9k
DOC Ensures that sklearn.base.clone passes numpydoc validation #21557
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
DOC Ensures that sklearn.base.clone passes numpydoc validation #21557
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks @kkatottn. Here is some feedback:
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Would you agree with my suggestion @ogrisel ?
Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com>
Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com>
Thanks for the feedback. I made changes, please review when you have chance @adrinjalali @ogrisel |
…t-learn#21557) * sklearn clone numpydoc validation fix * adjusting docstring and reverting earlier unrelated change * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com>
…t-learn#21557) * sklearn clone numpydoc validation fix * adjusting docstring and reverting earlier unrelated change * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com>
…t-learn#21557) * sklearn clone numpydoc validation fix * adjusting docstring and reverting earlier unrelated change * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com>
* sklearn clone numpydoc validation fix * adjusting docstring and reverting earlier unrelated change * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> * Update sklearn/base.py Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com> Co-authored-by: Adrin Jalali <adrin.jalali@gmail.com>
Reference Issues/PRs
Addresses #21350
What does this implement/fix? Explain your changes.
This PR fixes the following errors that were appearing for numpydoc validation for Base.clone():
Any other comments?
One interesting note: If the summary/description includes the word "yield", it causes the validator to expect a
Yields
section in addition to aReturns
section. However, including both also results in an error, and so it seems like it may be good practice to avoid using the keyword "yield" altogether inside of descriptions.