-
-
Notifications
You must be signed in to change notification settings - Fork 25.8k
Shorten and improve CONTRIBUTING.md #12801
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
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.
In shortening `CONTRIBUTING.md`, material deleted from `how to contribute` section are added onto `contributing.rst` if it doens't exist on the latter.
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? |
I'm not sure, it'd be nice if you could double check that. |
…into contributing_doc
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 |
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.
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"
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.
done ✅
CONTRIBUTING.md
Outdated
Guideline | ||
--------- | ||
|
||
Full contribution guidelines are available in the repository at `doc\`, or |
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.
how about explciitly mentioning doc/developers/contributing.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.
done ✅
doc/developers/contributing.rst
Outdated
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 |
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.
Missing space after comma
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.
done ✅
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.
Nice one, thanks @reshamas.
* 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...'
* 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...'
* 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...'
This reverts commit 9d8cdf1.
This reverts commit 9d8cdf1.
* 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...'
Referencing PR / Issue
This fixes #10892, closes #12144
Note
simplify CONTRIBUTING.md file
cc: @cecilialiao
cc: @eharris99 (12215 PR closed previously)
#wimlds