RFCs and ADRs #13
Description
Write guidelines to describe how new ideas or practices with a broad impact should be discussed and adopted and documented:
Request For Comments (RFC)
- Describe idea proposed
- Present POCs / MVPs / experimentation with results
- Should be in a format that makes discussions very easy (github PRs may not be the best format for this)
- Described other approaches that have been considered
- Eventually document decision
Architecture Decision Record (ADR)
- Describe a particular decision taken and rational
- Describe Impact to organisation and teams
- Ideally links to an RFC so people may get more contextual information should they wish