-
-
Notifications
You must be signed in to change notification settings - Fork 25.3k
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
[MRG+1] DOC Add libraries.io and changelog links #11298
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.
Only making the suggestion in one place seems enough from my side. This will be hard to maintain.
README.rst
Outdated
See the `changelog <http://scikit-learn.org/dev/whats_new.html>`__ | ||
for a history of notable changes to scikit-learn. | ||
|
||
.. The following two lines are duplicated in doc/whats_new.rst |
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 don't think comments like this in a README are appropriate. I'd rather remove this and the following reference to libraries.io. It is sufficient to have in what's new, or perhaps in installation instructions
I agree it's not ideal to have those comments to compensate for GitHub's impoverished rst renderer but think the benefit to users of also having the libraries.io link in the README far outweighed the small maintenance cost of having the link duplicated in both places. That said, I have removed the libraries.io link from the README and the associated comments so that this can be merged assuming this PR is now 👍. |
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, thanks @twosigmajab
@@ -78,6 +78,12 @@ or ``conda``:: | |||
The documentation includes more detailed `installation instructions <http://scikit-learn.org/stable/install.html>`_. | |||
|
|||
|
|||
Changelog |
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 think I'm fine with this unrelated change
The first commit in this PR closes #11287 by adding a "subscribe to releases on libraries.io" link to the "what's new" page:
I also noticed that there is no link to the changelog/what's new page from the https://github.com/scikit-learn/scikit-learn#readme content on GitHub, but I thought there should be: The "what's new" content is often the one thing that upgrading users are looking for, so I think it should be linked to from every top-level page. So the second commit in this PR adds a changelog link to the README that is displayed on GitHub, as well as another "subscribe to releases" link there as well.