SW Design, Architecture & Clarity at Scale
summary
Panel argues that lightweight Decision Records (short or long templates, draft status for collaboration) plus automation and placement where teams already work turn decisions into usable artifacts; shows ACE model for slicing design through context and architecture; cites a 3,000‑person org with 800–900 developers to justify repeated comms and platform engineering; recommends using OpenAPI for live API docs and observability plus scheduled feedback loops to detect when to supersede decisions.
AI-written summary · about
chapters (8)
- 0:00Intro
- 2:46What is software design?
- 4:21Decision‑Records: Why & how to use them
- 22:46Keeping documentation fresh – ADR templates & automation
- 29:44Bridging the Dev ↔ Architect gap
- 32:30Standardizing vs Over‑standardizing (Platform Engineering)
- 42:20Feedback loops & continuous improvement
- 45:00Outro
related talks
30mCommunicating and documenting architectural decisions
42mDecision-making for developers
26mHow a team that communicates well collaborates well
16mEveryone architect!
41mThe lost art of software design
39mOne Does Not Simply Make Architecture Decisions Alone: ADRs and Architec
30mJames Stanier, Winter Wi, Janet Balneaves a panel discussion at LeadDev London 2023
32mWriting design docs for wide audiences
