home.social

#adrs — Public Fediverse posts

Live and recent posts from across the Fediverse tagged #adrs, aggregated by home.social.

  1. Suben el riesgo país y caen los ADRs tras conocerse la inflación de abril

    📰 Título original: El riesgo país sube con fuerza y supera los 530 puntos, mientras los ADRs caen hasta 5,6%

    🤖 IA: No es clickbait ✅
    👥 Usuarios: No es clickbait ✅

    Ver resumen IA completo: es.killbait.com/suben-el-riesg

    #economía #riesgopaís #adrs #mer...

  2. Your #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? attilagyorffy.com/blog/the-ass

  3. Your #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? attilagyorffy.com/blog/the-ass

  4. Your #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? attilagyorffy.com/blog/the-ass

  5. 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 infomoney.com.br/mercados/como #ADRs #Bolsa

  6. Í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 infomoney.com.br/mercados/indi #ADRs #mercadofinanceiro

  7. Excited 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

  8. Excited 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

  9. Excited 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

  10. Excited 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

  11. Excited 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

  12. New 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.

    👉 authorial.org/byern/technical-

    #SoftwareEngineering #TechnicalDebt #Maintainability #EngineeringCulture #SoftwareArchitecture #Documentation #ADRs #KnowledgeManagement #ByernNotes

  13. New 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.

    👉 authorial.org/byern/technical-

    #SoftwareEngineering #TechnicalDebt #Maintainability #EngineeringCulture #SoftwareArchitecture #Documentation #ADRs #KnowledgeManagement #ByernNotes

  14. New 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.

    👉 authorial.org/byern/technical-

    #SoftwareEngineering #TechnicalDebt #Maintainability #EngineeringCulture #SoftwareArchitecture #Documentation #ADRs #KnowledgeManagement #ByernNotes

  15. The 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: bit.ly/43Ajl1y

    #InfoQ #QConSF #ADRs #TechLeadership #Culture

  16. The 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: bit.ly/43Ajl1y

    #InfoQ #QConSF #ADRs #TechLeadership #Culture

  17. The 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: bit.ly/43Ajl1y

    #InfoQ #QConSF #ADRs #TechLeadership #Culture

  18. The 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: bit.ly/43Ajl1y

    #InfoQ #QConSF #ADRs #TechLeadership #Culture

  19. The 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: bit.ly/43Ajl1y

  20. Understanding 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.

    #softwarearchitecture #documentation #ADRs

  21. Understanding 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.

  22. Understanding 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.

    #softwarearchitecture #documentation #ADRs

  23. Understanding 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.

    #softwarearchitecture #documentation #ADRs

  24. @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.

    #softwarearchitecture #ADRs

  25. @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.

    #softwarearchitecture #ADRs

  26. @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.

  27. @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.

    #softwarearchitecture #ADRs

  28. @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.

    #softwarearchitecture #ADRs

  29. I recently added the vault to my website with a new article: (Architecture Decision Records). Why isn’t this in the blog? The vault is designed to collect information together in long-form reference articles, whereas the blog posts are shorter or more transitory (but still useful!).

    What do you think of the ADRs article? What topics would you like me to cover in the knowledge vault?

    Vault: jacquiread.com/knowledge/?utm_
    ADRs article: jacquiread.com/knowledge/adrs/

  30. I recently added the #knowledge vault to my website with a new article: #ADRs (Architecture Decision Records). Why isn’t this in the blog? The vault is designed to collect information together in long-form reference articles, whereas the blog posts are shorter or more transitory (but still useful!).

    What do you think of the ADRs article? What topics would you like me to cover in the knowledge vault?

    Vault: jacquiread.com/knowledge/?utm_
    ADRs article: jacquiread.com/knowledge/adrs/

  31. I recently added the #knowledge vault to my website with a new article: #ADRs (Architecture Decision Records). Why isn’t this in the blog? The vault is designed to collect information together in long-form reference articles, whereas the blog posts are shorter or more transitory (but still useful!).

    What do you think of the ADRs article? What topics would you like me to cover in the knowledge vault?

    Vault: jacquiread.com/knowledge/?utm_
    ADRs article: jacquiread.com/knowledge/adrs/

  32. I recently added the #knowledge vault to my website with a new article: #ADRs (Architecture Decision Records). Why isn’t this in the blog? The vault is designed to collect information together in long-form reference articles, whereas the blog posts are shorter or more transitory (but still useful!).

    What do you think of the ADRs article? What topics would you like me to cover in the knowledge vault?

    Vault: jacquiread.com/knowledge/?utm_
    ADRs article: jacquiread.com/knowledge/adrs/

  33. I recently added the #knowledge vault to my website with a new article: #ADRs (Architecture Decision Records). Why isn’t this in the blog? The vault is designed to collect information together in long-form reference articles, whereas the blog posts are shorter or more transitory (but still useful!).

    What do you think of the ADRs article? What topics would you like me to cover in the knowledge vault?

    Vault: jacquiread.com/knowledge/?utm_
    ADRs article: jacquiread.com/knowledge/adrs/

  34. avoid mixing levels of abstraction.

    But can you take this too far? Absolutely. It is usually adequate to split a high-level criterion into no more than 3-4 lower-level criteria, but as usual it depends on the scope and complexity of your ADR.

    What has worked best for you?

    I’ll be sharing more on , , and so if you got value from this post please 🔔 follow and 🔗 share.

    (Image from my book, Communication Patterns, @OReillyMedia).
    5/5

  35. avoid mixing levels of abstraction.

    But can you take this too far? Absolutely. It is usually adequate to split a high-level criterion into no more than 3-4 lower-level criteria, but as usual it depends on the scope and complexity of your ADR.

    What has worked best for you?

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

    (Image from my book, Communication Patterns, @OReillyMedia).
    5/5

  36. avoid mixing levels of abstraction.

    But can you take this too far? Absolutely. It is usually adequate to split a high-level criterion into no more than 3-4 lower-level criteria, but as usual it depends on the scope and complexity of your ADR.

    What has worked best for you?

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

    (Image from my book, Communication Patterns, @OReillyMedia).
    5/5

  37. avoid mixing levels of abstraction.

    But can you take this too far? Absolutely. It is usually adequate to split a high-level criterion into no more than 3-4 lower-level criteria, but as usual it depends on the scope and complexity of your ADR.

    What has worked best for you?

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

    (Image from my book, Communication Patterns, @OReillyMedia).
    5/5

  38. avoid mixing levels of abstraction.

    But can you take this too far? Absolutely. It is usually adequate to split a high-level criterion into no more than 3-4 lower-level criteria, but as usual it depends on the scope and complexity of your ADR.

    What has worked best for you?

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

    (Image from my book, Communication Patterns, @OReillyMedia).
    5/5

  39. 3/3
    Be careful though, some of these constraints can be sensitive topics, such as having to follow a company master solution, or that the team does not have the skills to implement an option. Keep your ADR impartial. You should assume anybody in your organisation could read it.

    I’ll be sharing more on , , and so if you got value from this post please 🔔 follow and 🔗 share.

  40. 3/3
    Be careful though, some of these constraints can be sensitive topics, such as having to follow a company master solution, or that the team does not have the skills to implement an option. Keep your ADR impartial. You should assume anybody in your organisation could read it.

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

  41. 3/3
    Be careful though, some of these constraints can be sensitive topics, such as having to follow a company master solution, or that the team does not have the skills to implement an option. Keep your ADR impartial. You should assume anybody in your organisation could read it.

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

  42. 3/3
    Be careful though, some of these constraints can be sensitive topics, such as having to follow a company master solution, or that the team does not have the skills to implement an option. Keep your ADR impartial. You should assume anybody in your organisation could read it.

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

  43. 3/3
    Be careful though, some of these constraints can be sensitive topics, such as having to follow a company master solution, or that the team does not have the skills to implement an option. Keep your ADR impartial. You should assume anybody in your organisation could read it.

    I’ll be sharing more on #SoftwareArchitecture, #ADRs, and #SoftwareDiagraming so if you got value from this post please 🔔 follow and 🔗 share.

  44. Sonya Natanzon is giving some great reasons why decisions are important at