[Workshop] How to Document Your Decisions

on YouTube ↗02h 37m

" summary

Hands-on workshop on documenting architecture decisions for a business case, covering the Attribute-Driven Design (ADD) method, how to write an Architecture Vision document, and how to align architecture drivers with proposed solutions during architecture reviews. It also explains ATAM (Architecture Tradeoff Analysis Method) and walks participants through performing analysis of their decisions and creating an Architecture Vision document from scratch.

AI-written summary · about

" chapters (15)

1. 0:00Decision docs intro
2. 1:03What is architecture
3. 12:27Architecture design method
4. 21:40Vision doc structure
5. 35:56Types of architecture docs
6. 51:16Visualizing architecture
7. 1:07:39Working with stakeholders
8. 1:21:56Keeping docs updated
9. 1:38:08Case study: log collection
10. 2:07:02When to detail docs
11. 2:15:39C4 model
12. 2:21:21Architecture attributes
13. 2:28:51Architect roles
14. 2:31:21From developer to architect
15. 2:34:53Architecture resources

" related talks

• 30mCommunicating and documenting architectural decisionsDavid Ayers · The Lead Developer New York 2019
• 49mArchitecture assessmentsDmytro Ovcharenko · Software Architecture fwdays'23
• 45mSW Design, Architecture & Clarity at ScaleJacqui Read, Sam Newman, Simon Rohrer · GOTO Copenhagen 2025
• 51mIntroduction to Architectural KatasFrank Sons · International PHP Conference Spring 2019
• 57mVisualise, document and explore your software architectureSimon Brown · NDC London 2017
• 54mCommunicating, Sharing and Maintaining Architectural Decisions in Development TeamsMichele Orselli · phpday PUG Edition 2020
• 29mTools of Intentional ArchitecturesDinesh Ramadoss · Reliable Web Summit 2021
• 24mThe too many faces of ArchitectureMihaela Ghidersa · JSWORLD Conference 2022 Online