-
-
Notifications
You must be signed in to change notification settings - Fork 46.6k
Update PR template #7794
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
Update PR template #7794
Conversation
.github/pull_request_template.md
Outdated
* [ ] All functions and variable names follow Python naming conventions. | ||
* [ ] All function parameters and return values are annotated with Python [type hints](https://docs.python.org/3/library/typing.html). | ||
* [ ] All functions have [doctests](https://docs.python.org/3/library/doctest.html) that pass the automated testing. | ||
* [ ] All new algorithms have a URL in its comments that points to Wikipedia or other similar explanation. | ||
* [ ] All new algorithms have a URL in their comments that point to Wikipedia or another similar explanation. |
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.
Perhaps this
* [ ] All new algorithms have a URL in their comments that point to Wikipedia or another similar explanation. | |
* [ ] All new algorithms have a docstring containing a URL that point to Wikipedia or another similar explanation. |
or
* [ ] All new algorithms have a URL in their comments that point to Wikipedia or another similar explanation. | |
* [ ] All new algorithms include at least one URL that points to Wikipedia or another similar explanation. |
These make a bit more sense in my opinion
.github/pull_request_template.md
Outdated
@@ -11,10 +11,8 @@ | |||
* [ ] This pull request is all my own work -- I have not plagiarized. | |||
* [ ] I know that pull requests will not be merged if they fail the automated tests. | |||
* [ ] This PR only changes one algorithm file. To ease review, please open separate PRs for separate algorithms. | |||
* [ ] All new Python files are placed inside an existing directory. | |||
* [ ] All filenames are in all lowercase characters with no spaces or dashes. |
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.
Sorry but I like both of these. I know that continuous integration will catch these after the first commit but most first-time contributors (the majority of our contributors) cannot figure out how to change the filepath in GitHub UI so they are forced close the pr and then immediately open a duplicate. I would rather warn them of these rules before the make these mistakes.
The other modification look right to me.
Thanks for doing this. |
Describe your change:
I know that pull requests will not be merged if they fail the automated tests.
. Although this is good to have one more reminder I find this huge list a bit overwhelming.Checklist:
Fixes: #{$ISSUE_NO}
.