Update CONTRIBUTING.md (#567)

Signed-off-by: Anuraag Agrawal <anuraaga@gmail.com>
This commit is contained in:
Anuraag Agrawal
2022-05-17 22:57:08 +09:00
committed by GitHub
parent 51663613e2
commit 7f28c8c1cd

View File

@@ -4,8 +4,8 @@ We welcome contributions from the community. Please read the following guideline
## Coding Style ## Coding Style
- To ensure your change passes format checks, use run `make check`. To format your files, you can run `make format`. - To ensure your change passes format checks, run `make check`. To format your files, you can run `make format`.
- We follow standard Go table-driven tests and use the [`testify/require`](https://github.com/stretchr/testify#require-package) library to assert correctness. To verify all tests pass, you can run `make test`. - We follow standard Go table-driven tests and use an internal [testing library](./internal/testing/require) to assert correctness. To verify all tests pass, you can run `make test`.
## DCO ## DCO
@@ -57,14 +57,8 @@ You can add the sign off when creating the git commit via `git commit -s`.
## Code Reviews ## Code Reviews
* Indicate the priority of each comment, following this * A single approval is sufficient to merge. If a reviewer asks for changes in a PR they should be
[feedback ladder](https://www.netlify.com/blog/2020/03/05/feedback-ladders-how-we-encode-code-reviews-at-netlify/). addressed before the PR is merged, even if another reviewer has already approved the PR.
If none was indicated it will be treated as `[dust]`.
* A single approval is sufficient to merge, except when the change cuts
across several components; then it should be approved by at least one owner
of each component. If a reviewer asks for changes in a PR they should be
addressed before the PR is merged, even if another reviewer has already
approved the PR.
* During the review, address the comments and commit the changes _without_ squashing the commits. * During the review, address the comments and commit the changes _without_ squashing the commits.
This facilitates incremental reviews since the reviewer does not go through all the code again to This facilitates incremental reviews since the reviewer does not go through all the code again to
find out what has changed since the last review. find out what has changed since the last review.