-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat: Adding a proposal for the co existance of RFC and ADR records
- Loading branch information
1 parent
598ee85
commit e56e3b0
Showing
1 changed file
with
18 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
# RFC-005: Adoption of ADRs coexisting with RFCs in this repository | ||
|
||
## Summary | ||
|
||
Use the Request for Comments (RFC) and Architecture Decision Record (ADR) formats to discuss and record technical decisions for this and other products we support. | ||
|
||
## Problem | ||
|
||
The RFC format does not lend itself to decsions made in meetings. | ||
|
||
|
||
## Proposal | ||
|
||
While an RFC is useful to replace synchoronus communication, an ADR is useful to document an already made decision. An ADR won't come with as much of a communication overhead because the discussion was either recorded in an RFC and an ADR si resulting from that, or a meeting with all or key members of the team through discussion and debate. These records will clearly define and record the decisions that have been made outside of an RFC or be used to affirm the outcome of an RFC. | ||
|
||
Not using the RFC approach for decisions should be discouraged in the spirit of transparency and RFCs are a extremely good and efficient means of team communication (due to asynchronous nature) but there is also a need to document decisions made elsewhere. There are items that will affect technical decision making that will arrive without a preceding or replacement RFC. | ||
|
||
As documents they can both co-exist. |