Co-authored-by: XiaoBei <1505929057@qq.com>
This commit is contained in:
parent
1ae81c5311
commit
b99e998c05
@ -1,8 +1,8 @@
|
||||
# ADR Creation Process
|
||||
|
||||
1. Copy the `adr-template.md` file. Use the following filename pattern: `adr-next_number-title.md`
|
||||
2. Create a draft Pull Request if you want to get an early feedback.
|
||||
3. Make sure the context and solution is clear and well documented.
|
||||
2. Create a draft Pull Request if you want to get early feedback.
|
||||
3. Make sure the context and solution are clear and well documented.
|
||||
4. Add an entry to a list in the [README](./README.md) file.
|
||||
5. Create a Pull Request to propose a new ADR.
|
||||
|
||||
@ -14,7 +14,7 @@ An ADR is a document to document an implementation and design that may or may no
|
||||
|
||||
ADR creation is an **iterative** process. Instead of having a high amount of communication overhead, an ADR is used when there is already a decision made and implementation details need to be added. The ADR should document what the collective consensus for the specific issue is and how to solve it.
|
||||
|
||||
1. Every ADR should start with either an RFC or discussion where consensus has been met.
|
||||
1. Every ADR should start with either an RFC or a discussion where consensus has been met.
|
||||
|
||||
2. Once consensus is met, a GitHub Pull Request (PR) is created with a new document based on the `adr-template.md`.
|
||||
|
||||
@ -44,9 +44,9 @@ DRAFT -> PROPOSED -> LAST CALL yyyy-mm-dd -> ACCEPTED | REJECTED -> SUPERSEDED b
|
||||
ABANDONED
|
||||
```
|
||||
|
||||
* `DRAFT`: [optional] an ADR which is work in progress, not being ready for a general review. This is to present an early work and get an early feedback in a Draft Pull Request form.
|
||||
* `PROPOSED`: an ADR covering a full solution architecture and still in the review - project stakeholders haven't reached an agreed yet.
|
||||
* `LAST CALL <date for the last call>`: [optional] clear notify that we are close to accept updates. Changing a status to `LAST CALL` means that social consensus (of Cosmos SDK maintainers) has been reached and we still want to give it a time to let the community react or analyze.
|
||||
* `DRAFT`: [optional] an ADR which is a work in progress, not being ready for a general review. This is to present an early work and get early feedback in a Draft Pull Request form.
|
||||
* `PROPOSED`: an ADR covering a full solution architecture and still in the review - project stakeholders haven't reached an agreement yet.
|
||||
* `LAST CALL <date for the last call>`: [optional] Notify that we are close to accepting updates. Changing a status to `LAST CALL` means that social consensus (of Cosmos SDK maintainers) has been reached and we still want to give it a time to let the community react or analyze.
|
||||
* `ACCEPTED`: ADR which will represent a currently implemented or to be implemented architecture design.
|
||||
* `REJECTED`: ADR can go from PROPOSED or ACCEPTED to rejected if the consensus among project stakeholders will decide so.
|
||||
* `SUPERSEDED by ADR-xxx`: ADR which has been superseded by a new ADR.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user