-
Notifications
You must be signed in to change notification settings - Fork 15
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
Improve contribution documentations and add templates #816
Conversation
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.
Thanks for this! It is a good starting point!
In general looks good to me, just a couple of minor comments.
docs/pull_request_template.md
Outdated
|
||
# How has this been tested? | ||
|
||
Please describe the tests that you wrote to verify your changes. //FIXME: Do we want this? |
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.
Since in doubt, we could remove this for the moment, and add something about How has this been tested?
when we feel the need.
Usually tests should already be clear enough to be understood without much extra description, if some extra information is needed I'd see acceptable having that extra context in the description.
wdyt?
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.
Most of these can be implemented as checks in the CI, but some of them I find them at least valuable to maybe be included in the CONTRIBUTING.md
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.
Good, what is your proposal instead of the FIXME
😄 ?
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.
In order to make contributions (and reviewing them) easier, this PR:
CONTRIBUTING.md
file to include some suggestions on PRs, reviews and issues