diff --git a/docs/adr/2022-03-23-keep-discarded-adr.md b/docs/adr/2022-03-23-keep-discarded-adr.md new file mode 100644 index 00000000000..c792bcf6c4b --- /dev/null +++ b/docs/adr/2022-03-23-keep-discarded-adr.md @@ -0,0 +1,28 @@ +--- +slug: 16 +title: | + 16. Keep Rejected ADRs +authors: [] +tags: [Accepted] +--- + +## Status + +✔ + +## Context + +We have started using _Architecture Decision Records_ as our primary way to document the most important design decisions we take while developing Hydra Node, and this has proved effective in fostering fruitful discussions about major architecture changes. + +During the course of this project, we have sometimes had debates on various topics leading to rejection of [some ADRs](https://github.com/input-output-hk/hydra-poc/pull/230). It could be the case that a previously rejected proposal turns out to be interesting, either because the context and situation have changed enough to reevaluate a proposal, or as background for some new proposal. + +## Decision + +_therefore_ + +* We will keep rejected _Architecture Decision Records_ alongside accepted and draft ones, in the same location and format +* Rejected ADRs _must_ have tag `[Rejected]` set + +## Consequences + +Once attributed a _serial number_ an ADR keeps it "forever", whether it's rejected or accepted