Upvote for mentioning ADRs! ;) I really like the approach and as other comments already mentioned, this is a nice way to capture the "why" of specific decision

Upvote for mentioning ADRs! ;) I really like the approach and as other comments already mentioned, this is a nice way to capture the "why" of specific decisions that go beyond the "how" in the code. Here is a good starting point for people not familiar with ADRs: - https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions https://cognitect.com/blog/2011/11/15/documenting-architectu... - https://adr.github.io/ https://adr.github.io/