Philip Durbin 🚀 (Oct 07 2024 at 18:45): Philip Durbin 🚀 (Oct 07 2024 at 18:45):Any opinions on Architecture Decision Records (ADRs)?
I see they were mentioned once here in Zulip but I'm only just catching up, having heard about them in Fundamentals of Software Architecture. The book mentions adr-tools and I find the ADR records for that tool itself pretty interesting (0002-implement-as-shell-scripts.md, 0008-use-iso-8601-format-for-dates.md, etc.).
Philip Durbin 🚀 (Oct 07 2024 at 18:46):ADRs were first described by Michael Nygard at https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions
Oliver Bertuch (Oct 07 2024 at 19:10):We are using them for HERMES. Good stuff. Can recommend.
Oliver Bertuch (Oct 07 2024 at 19:10):There's lots of options to improve our Software Architecture. Writing down things as ADRs definitely is a good, low hanging fruit.
Philip Durbin 🚀 (Oct 07 2024 at 19:26):Are any of your ADRs open source?
Oliver Bertuch (Oct 07 2024 at 21:27):Of course! We even add them to our docs page. https://docs.software-metadata.pub/en/latest/adr/index.html
Oliver Bertuch (Oct 07 2024 at 21:28):I do admit we are not very good at updating them... :see_no_evil:
Philip Durbin 🚀 (Oct 07 2024 at 21:54):Very nice! Thanks!
Last updated: Nov 01 2025 at 14:11 UTC