Skip to content

[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

Closed

Conversation

cecilialiao
Copy link

Fixes #10892, by simplifying CONTRIBUTING.md and referencing to doc\ where appropriate.

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.
@qinhanmin2014
Copy link
Member

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.

@cecilialiao
Copy link
Author

cecilialiao commented Sep 28, 2018

That's a great shout, I will look to add the deleted content from CONTRIBUTING.md to contributing.rst if it's not already on the latter. Can I check on best practice on git usage? Should I make those changes to contributing.rst in the same branch shorten-contributing-md?

@qinhanmin2014
Copy link
Member

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.
Copy link
Member

@jnothman jnothman left a 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
Copy link
Member

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".
Copy link
Member

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"

@jnothman jnothman mentioned this pull request Sep 30, 2018
@eharris99
Copy link

Hi I also submitted some proposed edits to this file

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants