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

Skip to content

Conversation

@marenwestermann
Copy link
Member

Reference Issues/PRs

References #14312

What does this implement/fix? Explain your changes.

Documents the attributes fit_ and partial_fit_ in class Birch

Any other comments?

@marenwestermann
Copy link
Member Author

ping @adrinjalali

Comment on lines +395 to +400
fit_ : bool
True if `fit` method is called.
partial_fit_ : bool
True if `partial_fit` method is called.
Copy link
Member

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?

Copy link
Member

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

Copy link
Member

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?

Copy link
Member

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.

Copy link
Member

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.

Base automatically changed from master to main January 22, 2021 10:53
Copy link
Member

@jeremiedbb jeremiedbb left a 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)

@adrinjalali
Copy link
Member

I agree, we don't need to update the docstrings for the deprecated ones. Thanks for the work though @marenwestermann

@marenwestermann marenwestermann deleted the birch branch March 9, 2021 20:54
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.

6 participants