-
-
Notifications
You must be signed in to change notification settings - Fork 26.6k
DOC fit_ and partial_fit_ documentation for class Birch #18796
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
Conversation
|
ping @adrinjalali |
| fit_ : bool | ||
| True if `fit` method is called. | ||
| partial_fit_ : bool | ||
| True if `partial_fit` method is called. | ||
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.
I'd say we can make these private probably, @ogrisel do you happen to know if we need to keep these two as public?
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.
They are clearly for internal purpose only. We should make them private indeed
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.
So do we deprecate their usage while documenting for 2 versions or we just switch to only making them private?
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.
As much as I would love to just make them private, I think we need to follow the deprecation period.
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.
Usually we do not document deprecated features in the public docstrings. So I would rather be in favor of closing this doc PR and just merging the deprecation PR: #19297 instead.
jeremiedbb
left a comment
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.
lgtm.
(the deprecation is being done in #19297)
|
I agree, we don't need to update the docstrings for the deprecated ones. Thanks for the work though @marenwestermann |
Reference Issues/PRs
References #14312
What does this implement/fix? Explain your changes.
Documents the attributes
fit_andpartial_fit_in class BirchAny other comments?