docs: Update CONTRIBUTING.md (#9760)
## Description fix typo in "accommodating" and apply content standards to replace Latin with words (e.g. is now for example) and limit the use of "please" per https://developers.google.com/style/tone#politeness-and-use-of-please many new repos are using the Cosmos SDK repo as a good model to follow, so I thought to make this README the best README we can make it. Closes: #XXXX <!-- Add a description of the changes that this PR introduces and the files that are the most critical to review. --> --- ### Author Checklist *All items are required. Please add a note to the item if the item is not applicable and please add links to any relevant follow up issues.* I have... - [ ] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [ ] added `!` to the type prefix if API or client breaking change - [ ] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#pr-targeting)) - [ ] provided a link to the relevant issue or specification - [ ] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules) - [ ] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing) - [ ] added a changelog entry to `CHANGELOG.md` - [ ] included comments for [documenting Go code](https://blog.golang.org/godoc) - [ BB] updated the relevant documentation or specification - [ BB] reviewed "Files changed" and left comments if necessary - [ ] confirmed all CI checks have passed ### Reviewers Checklist *All items are required. Please add a note if the item is not applicable and please add your handle next to the items reviewed if you only reviewed selected items.* I have... - [x] confirmed the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [x] confirmed `!` in the type prefix if API or client breaking change - [ ] confirmed all author checklist items have been addressed - [ ] reviewed state machine logic - [ ] reviewed API design and naming - [x] reviewed documentation is accurate - [ ] reviewed tests and test coverage - [ ] manually tested (if applicable)
This commit is contained in:
parent
ee29beba26
commit
03b0d85cfe
|
@ -72,58 +72,57 @@ of how these are written refer to the current [ADRs](https://github.com/cosmos/c
|
||||||
|
|
||||||
## Pull Requests
|
## Pull Requests
|
||||||
|
|
||||||
PRs should be categorically broken up based on the type of changes being made (i.e. `fix`, `feat`,
|
PRs should be categorically broken up based on the type of changes being made (for example, `fix`, `feat`,
|
||||||
`refactor`, `docs`, etc.). The *type* must be included in the PR title as a prefix (e.g.
|
`refactor`, `docs`, and so on). The *type* must be included in the PR title as a prefix (for example,
|
||||||
`fix: <description>`). This ensures that all changes committed to the base branch follow the
|
`fix: <description>`). This convention ensures that all changes that are committed to the base branch follow the
|
||||||
[Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification.
|
[Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification.
|
||||||
Additionally, each PR should only address a single issue.
|
Additionally, each PR should only address a single issue.
|
||||||
|
|
||||||
### Pull Request Templates
|
### Pull Request Templates
|
||||||
|
|
||||||
There are currently three PR templates. The [default template](./.github/PULL_REQUEST_TEMPLATE.md) is for types `fix`, `feat`, and `refactor`. We also have a [docs template](./.github/PULL_REQUEST_TEMPLATE/docs.md) for documentation changes and an [other template](./.github/PULL_REQUEST_TEMPLATE/other.md) for changes that do not affect production code. When previewing a PR before it has been opened, you can change the template by adding one of the following parameters to the url:
|
There are three PR templates. The [default template](./.github/PULL_REQUEST_TEMPLATE.md) is for types `fix`, `feat`, and `refactor`. We also have a [docs template](./.github/PULL_REQUEST_TEMPLATE/docs.md) for documentation changes and an [other template](./.github/PULL_REQUEST_TEMPLATE/other.md) for changes that do not affect production code. When previewing a PR before it has been opened, you can change the template by adding one of the following parameters to the url:
|
||||||
|
|
||||||
- `template=docs.md`
|
- `template=docs.md`
|
||||||
- `template=other.md`
|
- `template=other.md`
|
||||||
|
|
||||||
### Requesting Reviews
|
### Requesting Reviews
|
||||||
|
|
||||||
In order to accomodate the review process, the author of the PR must complete the author checklist
|
In order to accommodate the review process, the author of the PR must complete the author checklist
|
||||||
to the best of their abilities before marking the PR as "Ready for Review". If you would like to
|
to the best of their abilities before marking the PR as "Ready for Review". If you would like to
|
||||||
receive early feedback on the PR, open the PR as a "Draft" and leave a comment in the PR indicating
|
receive early feedback on the PR, open the PR as a "Draft" and leave a comment in the PR indicating
|
||||||
that you would like early feedback and tagging whoever you would like to receive feedback from.
|
that you would like early feedback and tagging whoever you would like to receive feedback from.
|
||||||
|
|
||||||
### Reviewing Pull Requests
|
### Reviewing Pull Requests
|
||||||
|
|
||||||
All PRs require at least two reviews before they can be merged (one review might be acceptable in
|
All PRs require at least two review approvals before they can be merged (one review might be acceptable in
|
||||||
the case of minor changes to [docs](./.github/PULL_REQUEST_TEMPLATE/docs.md) or [other](./.github/PULL_REQUEST_TEMPLATE/other.md) changes that do not affect production code). Each PR template has a
|
the case of minor changes to [docs](./.github/PULL_REQUEST_TEMPLATE/docs.md) or [other](./.github/PULL_REQUEST_TEMPLATE/other.md) changes that do not affect production code). Each PR template has a reviewers checklist that must be completed before the PR can be merged. Each reviewer is responsible
|
||||||
reviewers checklist that must be completed before the PR can be merged. Each reviewer is responsible
|
|
||||||
for all checked items unless they have indicated otherwise by leaving their handle next to specific
|
for all checked items unless they have indicated otherwise by leaving their handle next to specific
|
||||||
items. In addition, please use the following review explanations:
|
items. In addition, use the following review explanations:
|
||||||
|
|
||||||
- `LGTM` without an explicit approval means that the changes look good, but you haven't thoroughly reviewed the reviewer checklist items.
|
- `LGTM` without an explicit approval means that the changes look good, but you haven't thoroughly reviewed the reviewer checklist items.
|
||||||
- `Approval` means that you have completed some or all of the reviewer checklist items. If you only reviewed selected items, you have added your handle next to the items that you have reviewed. In addition, please follow these guidelines:
|
- `Approval` means that you have completed some or all of the reviewer checklist items. If you only reviewed selected items, you must add your handle next to the items that you have reviewed. In addition, follow these guidelines:
|
||||||
- You must also think through anything which ought to be included but is not
|
- You must also think through anything which ought to be included but is not
|
||||||
- You must think through whether any added code could be partially combined (DRYed) with existing code
|
- You must think through whether any added code could be partially combined (DRYed) with existing code
|
||||||
- You must think through any potential security issues or incentive-compatibility flaws introduced by the changes
|
- You must think through any potential security issues or incentive-compatibility flaws introduced by the changes
|
||||||
- Naming must be consistent with conventions and the rest of the codebase
|
- Naming must be consistent with conventions and the rest of the codebase
|
||||||
- Code must live in a reasonable location, considering dependency structures (e.g. not importing testing modules in production code, or including example code modules in production code).
|
- Code must live in a reasonable location, considering dependency structures (for example, not importing testing modules in production code, or including example code modules in production code).
|
||||||
- If you approve of the PR, you are responsible for any issues mentioned here and any issues that should have been addressed after thoroughly reviewing the reviewer checklist items in the pull request template.
|
- If you approve the PR, you are responsible for any issues mentioned here and any issues that should have been addressed after thoroughly reviewing the reviewer checklist items in the pull request template.
|
||||||
- If you sat down with the PR submitter and did a pairing review please note that in the `Approval`, or your PR comments.
|
- If you sat down with the PR submitter and did a pairing review, add this information in the `Approval` or your PR comments.
|
||||||
- If you are only making "surface level" reviews, submit any notes as `Comments` without adding a review.
|
- If you are only making "surface level" reviews, submit any notes as `Comments` without adding a review.
|
||||||
|
|
||||||
### Updating Documentation
|
### Updating Documentation
|
||||||
|
|
||||||
If you open a PR on the Cosmos SDK, it is mandatory to update the relevant documentation in `/docs`.
|
If you open a PR on the Cosmos SDK, it is mandatory to update the relevant documentation in `/docs`.
|
||||||
|
|
||||||
- If your change relates to the core SDK (baseapp, store, ...), please update the `docs/basics/`, `docs/core/` and/or `docs/building-modules/` folders.
|
- If your change relates to the core SDK (baseapp, store, ...), be sure to update the content in `docs/basics/`, `docs/core/` and/or `docs/building-modules/` folders.
|
||||||
- If your changes relate to the core of the CLI (not specifically to module's CLI/Rest), please modify the `docs/run-node/` folder.
|
- If your changes relate to the core of the CLI (not specifically to module's CLI/Rest), then modify the content in the `docs/run-node/` folder.
|
||||||
- If your changes relate to a module, please update the module's spec in `x/moduleName/docs/spec/`.
|
- If your changes relate to a module, then be sure to update the module's spec in `x/moduleName/docs/spec/`.
|
||||||
|
|
||||||
When writing documentation, follow the [Documentation Writing Guidelines](./docs/DOC_WRITING_GUIDELINES.md).
|
When writing documentation, follow the [Documentation Writing Guidelines](./docs/DOC_WRITING_GUIDELINES.md).
|
||||||
|
|
||||||
## Forking
|
## Forking
|
||||||
|
|
||||||
Please note that Go requires code to live under absolute paths, which complicates forking.
|
Go requires code to live under absolute paths, and this requirement complicates forking.
|
||||||
While my fork lives at `https://github.com/rigeyrigerige/cosmos-sdk`,
|
While my fork lives at `https://github.com/rigeyrigerige/cosmos-sdk`,
|
||||||
the code should never exist at `$GOPATH/src/github.com/rigeyrigerige/cosmos-sdk`.
|
the code should never exist at `$GOPATH/src/github.com/rigeyrigerige/cosmos-sdk`.
|
||||||
Instead, we use `git remote` to add the fork as a new remote for the original repo,
|
Instead, we use `git remote` to add the fork as a new remote for the original repo,
|
||||||
|
|
Loading…
Reference in New Issue