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

docs: update adr section of contributing #9710

Merged
merged 6 commits into from
Jul 28, 2021
Merged

Conversation

ryanchristo
Copy link
Collaborator

Description

ref #9708

This pull request updates the ADR section of the contributing documentation to clarify that an issue or discussion should be opened (a proposal should be created) before submitting a pull request with the initial draft of the decision record.


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 docs: prefix in the PR title
  • targeted the correct branch (see PR Targeting)
  • provided a link to the relevant issue or specification
  • followed the documentation writing guidelines
  • 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...

  • confirmed the correct docs: prefix in the PR title
  • confirmed all author checklist items have been addressed
  • confirmed that this PR only changes documentation
  • reviewed content for consistency
  • reviewed content for thoroughness
  • reviewed content for spelling and grammar
  • tested instructions (if applicable)

CONTRIBUTING.md Outdated
so further discussions can be made. We are following this process so all involved parties are in
agreement before any party begins coding the proposed implementation. If you would like to see some examples
of how these are written refer to the current [ADRs](https://github.com/cosmos/cosmos-sdk/tree/master/docs/architecture).
When proposing an architecture decision for the SDK, please start by opening an [issue](https://github.com/cosmos/cosmos-sdk/issues/new/choose) or a [discussion](https://github.com/cosmos/cosmos-sdk/discussions/new) with a summary of the proposal. Once the proposal has been discussed and there is an agreed upon design, the [ADR creation process](https://github.com/cosmos/cosmos-sdk/blob/master/docs/architecture/PROCESS.md) can begin. We are following this process to ensure all involved parties are in agreement before any party begins coding the proposed implementation. If you would like to see examples of how these are written, please refer to the current [ADRs](https://github.com/cosmos/cosmos-sdk/tree/master/docs/architecture).
Copy link
Member

Choose a reason for hiding this comment

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

nit: Many times the design process will happen in the ADR. We should not limit designs to pre ADR phase.

@orijbot
Copy link

orijbot commented Jul 26, 2021

Visit https://dashboard.github.orijtech.com?pr=9710&repo=cosmos%2Fcosmos-sdk to see benchmark details.

CONTRIBUTING.md Outdated Show resolved Hide resolved
@ryanchristo ryanchristo added the A:automerge Automatically merge PR once all prerequisites pass. label Jul 27, 2021
@ryanchristo ryanchristo merged commit 8f7be3e into master Jul 28, 2021
@ryanchristo ryanchristo deleted the ryan/docs-adr-contribute branch July 28, 2021 04:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A:automerge Automatically merge PR once all prerequisites pass.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants