-
-
Notifications
You must be signed in to change notification settings - Fork 25.8k
[WIP] Shorten and improve CONTRIBUTING.md #10892 #12144
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
[WIP] Shorten and improve CONTRIBUTING.md #10892 #12144
Conversation
Simplified CONTRIBUTING.md by removing content that already exists in contributing.rst. Added Code of Conduct reference as seen in a few other CONTRIBUTING.md of popular libraries.
I think we need to ensure that everything we remove in CONTRIBUTING.md is included the contributing guide. E.g., some entries in Pull Request Checklist are not included in the contributing guide. |
That's a great shout, I will look to add the deleted content from |
Yes, simply push commits to that branch and they'll appear in the PR |
In shortening `CONTRIBUTING.md`, material deleted from `how to contribute` section are added onto `contributing.rst` if it doens't exist on the latter.
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.
This looks much better IMO
|
||
But there are many other ways to help. In particular answering queries on the | ||
[issue tracker](https://github.com/scikit-learn/scikit-learn/issues), | ||
investigating bugs, and [reviewing other developers pull |
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.
Apostrophe after "developers" please
Another way to contribute is to report issues you're facing, and give a "thumbs | ||
up" on issues that others reported and that are relevant to you. It also helps | ||
us if you spread the word: reference the project from your blog and articles, | ||
link to it from your website, or simply star to say "I use it". |
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.
"star" -> "star it in GitHub"
Hi I also submitted some proposed edits to this file |
Fixes #10892, by simplifying
CONTRIBUTING.md
and referencing todoc\
where appropriate.