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

Improve contribution documentations and add templates #816

Merged
merged 3 commits into from
Sep 23, 2022

Conversation

rtorrero
Copy link
Contributor

In order to make contributions (and reviewing them) easier, this PR:

  • Expands the CONTRIBUTING.md file to include some suggestions on PRs, reviews and issues
  • Adds templates for PRs and issues

Copy link
Member

@nelsonkopliku nelsonkopliku left a 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.

CONTRIBUTING.md Outdated Show resolved Hide resolved

# How has this been tested?

Please describe the tests that you wrote to verify your changes. //FIXME: Do we want this?
Copy link
Member

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?

Copy link
Contributor Author

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

Copy link
Member

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 😄 ?

Copy link
Member

@nelsonkopliku nelsonkopliku left a comment

Choose a reason for hiding this comment

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

:shipit:

@rtorrero rtorrero merged commit 0f3ca06 into main Sep 23, 2022
@rtorrero rtorrero deleted the contribution-guideline branch September 23, 2022 14:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

3 participants