BlemeStop à la dette documentaire : Industrialisez vos ADRs et READMEs avec Spec-kit
PeerTube
Attila GyörffyYour #architecture decision records capture what was decided and why. They don't capture what you believed was true at the time. When an assumption breaks — "users will do this" — how do you find every decision built on that belief? Re-read all 300 #ADRs & pray? https://www.attilagyorffy.com/blog/the-assumption-nobody-wrote-down/
News e vocêComo foram os ADRs no feriado e o que isso indica para a abertura da Bolsa hoje: Índice de ADRs brasileiros caiu na contramão de índices de Nova York https://www.infomoney.com.br/mercados/como-foram-adrs-feriado-o-que-indica-para-abertura-bolsa-quarta-cinzas/ #ADRs #Bolsa
Índice de ADRs brasileiros cai seguindo EUA por preocupações com IA; Vale tem baixa: Preocupações sobre inteligência artificial seguem afetando o sentimento do mercado https://www.infomoney.com.br/mercados/indice-de-adrs-brasileiros-feriado-carnaval-17022026/ #ADRs #mercadofinanceiro
Nicolas Fränkel 🇪🇺🇺🇦🇬🇪How to Make #Architecture Decisions: #RFCs, #ADRs, and Getting Everyone Aligned
JCONExcited for #JCON EUROPE 2026? See Piet van Dongen at #JCON2026 in Cologne talking about 'Creating Effective and Objective Architectural Decision Records #ADRs'
#Documenting decisions is like eating your veggies as a kid: they …
🎟️ 2026.europe.jcon.one/tickets
Free for #JUG members
Thomas ByernNew article is live on my WriteFreely:
“Technical debt isn’t just code, it’s lost context.”
Most teams can point at code debt: missing tests, messy modules, shortcuts taken under pressure. The harder (and often more expensive) debt is the part you cannot point to: the *why* that evaporated. The moment a reasonable decision becomes an undocumented assumption, then a “hard requirement,” and finally a constraint that nobody dares to touch.
The article is built around a pattern I keep seeing in real systems: **Decision → Assumption → Constraint → Incident (or slow bleed)**, plus the symptoms that show up in delivery, operations, and team dynamics when context turns into folklore.
I also propose a few lightweight countermeasures that do not require a documentation bureaucracy: mini-ADRs that take ten minutes, PR prompts that force future-facing context into the open, a simple “folklore detection” checklist, and a realistic 30-day adoption plan for normal teams.
If you’ve ever inherited a system where “don’t touch that, it caused an incident last time” was considered documentation, this one is for you.
👉 https://authorial.org/byern/technical-debt-isnt-just-code-its-lost-context
#SoftwareEngineering #TechnicalDebt #Maintainability #EngineeringCulture #SoftwareArchitecture #Documentation #ADRs #KnowledgeManagement #ByernNotes
InfoQThe real consequential decisions in engineering aren't made in sprint planning. They're hidden in the 'invisible choices': metrics, defaults & everyday behaviors.
The industry is focused on the wrong things. The choices that truly shape systems & culture are the ones that go unnoticed and unexamined.
Read the full insights: https://bit.ly/43Ajl1y
Sebastian HansUnderstanding a software system by reading ADRs is a bit like event-sourcing its architecture in your head. You get the whole history (enabling deeper understanding), but if you just want to get information about the present state, it's not very efficient. Hence, keeping a snapshot of the current state (a read model if you will) in some form is still worthwhile.
@RuthMalan It's the "and then" part that's the problem. I write the ADR before making the decision, using it to drive discussion and evaluate options (and record the options, too). That's where most of the value comes from for me.
ADRs are rarely needed afterwards, but when they are (mostly during onboarding of new team members, but maybe also if something doesn't turn out the way we imagined), they are an immensely useful tool for understanding the thinking that went into the decision.
In other words (because I've been thinking about Peter Naur's Theory Building View lately), ADRs can help people (re)build the theory of the system in their minds if necessary, keeping it alive. People who already possess the theory don't need to read them, and this is a good thing.