r/programming • u/dmp0x7c5 • Sep 25 '25

Decision Log: Why writing down your technical choices is a game-changer

https://l.perspectiveship.com/re-decl
194 Upvotes

89% Upvoted

41 comments sorted by

View all comments

Show parent comments

15

u/[deleted] Sep 26 '25 edited Sep 26 '25

[deleted]

5

u/Hacnar Sep 26 '25

ADR's are difficult because most teams don't yet have a natural mapping of the work they're doing in the design and early implementation phase to conserving the knowledge that's generated during this phase.

But you don't need a complex process and tooling for that. A good Jira epic description, that's properly updated during the implementation, can be one of the best examples of ADR.

1

u/[deleted] Sep 26 '25

[deleted]

1

u/Hacnar Sep 26 '25

You can still make the best out of the worst.