Skip to content
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

Shorten and improve CONTRIBUTING.md #12801

Merged
merged 12 commits into from
Dec 19, 2018
Merged

Shorten and improve CONTRIBUTING.md #12801

merged 12 commits into from
Dec 19, 2018

Conversation

reshamas
Copy link
Member

Referencing PR / Issue

This fixes #10892, closes #12144

Note

simplify CONTRIBUTING.md file

cc: @cecilialiao
cc: @eharris99 (12215 PR closed previously)
#wimlds

cecilialiao and others added 6 commits September 24, 2018 13:34
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.
In shortening `CONTRIBUTING.md`, material deleted from `how to contribute` section are added onto `contributing.rst` if it doens't exist on the latter.
@adrinjalali
Copy link
Member

Interesting, is the content being removed from the file all also included in the other file?

@reshamas
Copy link
Member Author

Interesting, is the content being removed from the file all also included in the other file?

Not sure. I did see a merge conflict when syncing. Did I lose content?

@adrinjalali
Copy link
Member

I'm not sure, it'd be nice if you could double check that.

@reshamas
Copy link
Member Author

@jnothman Will you be other reviewer on this one? I see you made previous comments on PR #12144

CONTRIBUTING.md Outdated
documentation is no less important than improving the library itself. If you
find a typo in the documentation, or have made improvements, do not hesitate to
send an email to the mailing list or preferably submit a GitHub pull request.
Full documentation can be found under the
Copy link
Member

Choose a reason for hiding this comment

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

It's not honest to say "Full documentation" as the documentation includes API docstrings and the example gallery, which do not live in doc. Perhaps just say "Documentation"

Copy link
Member Author

Choose a reason for hiding this comment

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

done ✅

CONTRIBUTING.md Outdated
Guideline
---------

Full contribution guidelines are available in the repository at `doc\`, or
Copy link
Member

Choose a reason for hiding this comment

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

how about explciitly mentioning doc/developers/contributing.rst?

Copy link
Member Author

Choose a reason for hiding this comment

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

done ✅

method does to the data. Then, it is very helpful to point out why the feature is
useful and when it should be used - the latter also including "big O"
(:math:`O\left(g\left(n\right)\right)`) complexities of the algorithm, as opposed
to just *rules of thumb*,as the latter can be very machine-dependent. If those
Copy link
Member

Choose a reason for hiding this comment

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

Missing space after comma

Copy link
Member Author

Choose a reason for hiding this comment

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

done ✅

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

Nice one, thanks @reshamas.

@adrinjalali adrinjalali merged commit 552a88e into scikit-learn:master Dec 19, 2018
@reshamas reshamas deleted the contributing_doc branch December 26, 2018 13:37
adrinjalali pushed a commit to adrinjalali/scikit-learn that referenced this pull request Jan 7, 2019
* Reuse intro from contributing.rst

* Removed content already on rst

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.

* Update contributing.rst

In shortening `CONTRIBUTING.md`, material deleted from `how to contribute` section are added onto `contributing.rst` if it doens't exist on the latter.

* added full link to .rst file + removed 'Full' in 'Full Docum...'
jnothman pushed a commit to jnothman/scikit-learn that referenced this pull request Feb 19, 2019
* Reuse intro from contributing.rst

* Removed content already on rst

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.

* Update contributing.rst

In shortening `CONTRIBUTING.md`, material deleted from `how to contribute` section are added onto `contributing.rst` if it doens't exist on the latter.

* added full link to .rst file + removed 'Full' in 'Full Docum...'
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
* Reuse intro from contributing.rst

* Removed content already on rst

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.

* Update contributing.rst

In shortening `CONTRIBUTING.md`, material deleted from `how to contribute` section are added onto `contributing.rst` if it doens't exist on the latter.

* added full link to .rst file + removed 'Full' in 'Full Docum...'
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
xhluca pushed a commit to xhluca/scikit-learn that referenced this pull request Apr 28, 2019
koenvandevelde pushed a commit to koenvandevelde/scikit-learn that referenced this pull request Jul 12, 2019
* Reuse intro from contributing.rst

* Removed content already on rst

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.

* Update contributing.rst

In shortening `CONTRIBUTING.md`, material deleted from `how to contribute` section are added onto `contributing.rst` if it doens't exist on the latter.

* added full link to .rst file + removed 'Full' in 'Full Docum...'
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.

Shorten and improve CONTRIBUTING.md
4 participants