Skip to content

[MRG] DOC add versionadded versionchanged for 0.21#16737

Merged
thomasjpfan merged 9 commits intoscikit-learn:masterfrom
gorski-m:versionadded
May 10, 2020
Merged

[MRG] DOC add versionadded versionchanged for 0.21#16737
thomasjpfan merged 9 commits intoscikit-learn:masterfrom
gorski-m:versionadded

Conversation

@gorski-m
Copy link
Copy Markdown
Contributor

Part of work in #15426.

I think there shouldn't have been anything added in files:
sklearn/compose/_column_transformer.py
sklearn/ensemble/_voting.py
but I decided to include these changes too. I will just remove them if necessary.

@gorski-m gorski-m changed the title DOC add versionadded versionchanged for 0.21 [WIP] DOC add versionadded versionchanged for 0.21 Mar 21, 2020
@gorski-m
Copy link
Copy Markdown
Contributor Author

@jnothman @adrinjalali @cmarmo could you have a look?

Copy link
Copy Markdown
Member

@adrinjalali adrinjalali left a comment

Choose a reason for hiding this comment

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

I didn't check for completeness, but these changes look good to me, except the two notes I'm not sure about. Thanks @Reksbril

I'll wait for another review before changing what you have.

Comment on lines +762 to +764
.. versionchanged:: 0.21
``n_components_`` was renamed to ``n_connected_components_``.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'm not sure if we need these. Its true that the attribute was renamed, but from the perspective of n_connected_components_, nothing has changed since its introduction. Not sure if we should do a versionadded instead or not. WDYT @jnothman ?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I feel like these might be useful, e.g. for a user to understand why and when their code started to break. No strong opinion though

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Maybe versionadded and:

n_connected_components_ was added to replace n_components_

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

+1 for the @thomasjpfan versionadded formulation.

@cmarmo cmarmo added Needs work Needs Decision Requires decision and removed Needs work labels Apr 14, 2020
@gorski-m
Copy link
Copy Markdown
Contributor Author

@jnothman @cmarmo could you have a look?

@gorski-m
Copy link
Copy Markdown
Contributor Author

@jnothman @cmarmo ping

Copy link
Copy Markdown
Member

@NicolasHug NicolasHug left a comment

Choose a reason for hiding this comment

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

Thanks for the PR and for your patience @Reksbril

Made a few comments but mostly looks good. Just not sure about the usefulness of some of these

Comment on lines +762 to +764
.. versionchanged:: 0.21
``n_components_`` was renamed to ``n_connected_components_``.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I feel like these might be useful, e.g. for a user to understand why and when their code started to break. No strong opinion though

"""Finds the K-neighbors of a point.
Returns indices of and distances to the neighbors of each point.

.. versionchanged:: 0.21
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I feel like we wouldn't need these. Thoughts @adrinjalali ?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I agree we do not need the versionchanged for NotFittedError.

gorski-m and others added 2 commits April 27, 2020 08:54
Co-Authored-By: Nicolas Hug <contact@nicolas-hug.com>
Copy link
Copy Markdown
Member

@NicolasHug NicolasHug left a comment

Choose a reason for hiding this comment

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

Thanks @Reksbril

LGTM, though I think we don't need the NotFittedError entries. Let's see what others think

@NicolasHug NicolasHug changed the title [WIP] DOC add versionadded versionchanged for 0.21 [MRG] DOC add versionadded versionchanged for 0.21 Apr 28, 2020
@cmarmo cmarmo removed the Needs Decision Requires decision label Apr 28, 2020
@gorski-m
Copy link
Copy Markdown
Contributor Author

@adrinjalali @ThomasDelteil could you check?

@cmarmo
Copy link
Copy Markdown
Contributor

cmarmo commented May 10, 2020

Hi @Reksbril could you please modify the n_connected_components_ directive as proposed in @thomasjpfan comment? Then LGTM for me. Thanks!

@gorski-m
Copy link
Copy Markdown
Contributor Author

@cmarmo oh, thanks, I've missed this one

The estimated number of connected components in the graph.

.. versionchanged:: 0.21
``n_components_`` was renamed to ``n_connected_components_``
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Should be modified as above (versionchanged -> versionadded)

@gorski-m
Copy link
Copy Markdown
Contributor Author

@cmarmo I've made the requested change

@cmarmo
Copy link
Copy Markdown
Contributor

cmarmo commented May 10, 2020

@thomasjpfan this is the last PR to close #15426. I suppose failing checks are related to the current work on check_estimator ... Shall we merge this one? Thanks!

@thomasjpfan thomasjpfan merged commit 534f8ae into scikit-learn:master May 10, 2020
@thomasjpfan
Copy link
Copy Markdown
Member

Thank you for the ping @cmarmo and thank you for the PR @Reksbril !

adrinjalali pushed a commit to adrinjalali/scikit-learn that referenced this pull request May 11, 2020
Co-authored-by: Mateusz Górski <mateuszg122@gmail.com>
Co-authored-by: Nicolas Hug <contact@nicolas-hug.com>
Co-authored-by: Thomas J Fan <thomasjpfan@gmail.com>
adrinjalali pushed a commit that referenced this pull request May 12, 2020
Co-authored-by: Mateusz Górski <mateuszg122@gmail.com>
Co-authored-by: Nicolas Hug <contact@nicolas-hug.com>
Co-authored-by: Thomas J Fan <thomasjpfan@gmail.com>
gio8tisu pushed a commit to gio8tisu/scikit-learn that referenced this pull request May 15, 2020
Co-authored-by: Mateusz Górski <mateuszg122@gmail.com>
Co-authored-by: Nicolas Hug <contact@nicolas-hug.com>
Co-authored-by: Thomas J Fan <thomasjpfan@gmail.com>
viclafargue pushed a commit to viclafargue/scikit-learn that referenced this pull request Jun 26, 2020
Co-authored-by: Mateusz Górski <mateuszg122@gmail.com>
Co-authored-by: Nicolas Hug <contact@nicolas-hug.com>
Co-authored-by: Thomas J Fan <thomasjpfan@gmail.com>
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.

5 participants