#TIL 🤓 There is a concept called "Architectural Decision Record" #ADR, see https://adr.github.io/.

ADRs are used to document architecture decisions in software project to facilitate discussions in the (far) future.

I think with the same motivation also non-software-related important decisions in teams and other collaborative groups should be systematically documented.

Thanks to @blinry and @zormit who talked about this topic within their @teamtype talk at recent @clt_news

Record of the talk, see

https://fosstodon.org/@teamtype/116306494351405176

Вася уволился — и унёс с собой 80% знаний о системе

Однажды утром вы открываете задачу и понимаете: единственный человек, который знал, как это работает, вчера уволился. Знания ушли вместе с ним.

https://habr.com/ru/companies/simpleone/articles/1017882/

#bus_factor #база_знаний #онбординг #adr #документация #управление_знаниями #code_review

Software Patterns guru Martin Fowler sanctions (Software) Architecture Decision Records (ADRs) as a good document type to add to a software architect's arsenal.

ADR's were coined by Michael T. Nygard in this 2011 article published in a cognitek blog:

https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions

TL;DR? You can get a feel for the document's structure and content here:

https://martinfowler.com/articles/building-infrastructure-platform.html#ArchitecturalDecisionRecords

"Architecture Decision Record"

https://martinfowler.com/bliki/ArchitectureDecisionRecord.html

#adr #softwaredevelopment #softwarearchitecture #documentation

Всё про ИТ-архитектуру: монолит и микросервисы, системное мышление — интервью с Филиппом Дельгядо

Архитектура в ИТ — это не «нарисовать диаграмму» и не «выбрать стек». Это работа со сложностью: там, где одной команде уже тесно, где требования конфликтуют, а решения нужно держать в голове годами. В этом интервью я, Александр Шулепов (телеграм-канал Shulepov Code), поговорил с Филиппом Дельгядо — архитектором финтех-продуктов и создателем сайта lekton.io — о том, с чего начинается архитектура, почему «монолит vs микросервисы» не решается одной фразой и какие навыки действительно определяют уровень специалиста.

https://habr.com/ru/articles/1015988/

#итархитектура #архитектор_по #микросервисы #монолиты #системное_мышление #ddd #rfc #adr

CERN has announced they had successfully transported antimatter by using the truck.

The question is: what ADR category antimatter falls under?

#cern #physics #antimatter #truck #adr

● 更好追溯的決策紀錄，讓架構變更討論更聚焦

Tor Project 的系統管理員團隊 TPA 最近把做決策的方式，從過去的 RFC（Request For Comments）改為 ADR（Architecture Decision Record）。不僅是通知變更何時上線，也把提案的背景與取捨交代清楚。

這套 ADR 流程的重點在「讓文件易讀好懂」與「責任劃分更明確」。模板從容易長篇的結構精簡到 5 個面向。流程也調整節奏。重大決策在會議說明，較小決策則用 email。

TPA 會先釐清每項決策的決策者。再定義被諮詢者與需被告知者。對齊經典的 RACI，降低「人人都想發言」造成的自行車棚效應。

最後，TPA 也把「做決策與記錄決策」和「對外溝通決策」拆開。ADR 文件專注在記錄決策本身。外部說明則用更像五何法（Five Ws）的方式重新整理，讓讀者快速抓到重點。

決策紀錄更容易一眼消化。權責更清楚。討論不容易無止境延續。

文章連結： https://anoni.net/docs/blog/2026/03/tpa-adr/

#ADR #OpenSource #TorProject #Documentation

Интересные кейсы про ADR + ИИ

Всем привет! Меня зовут Катя, я развиваю

https://habr.com/ru/companies/gram_ax/articles/1010500/

#adr #architectural_decision_records #docs_as_code