Visualise, Document & Explore Your Software Architecture • Simon Brown • GOTO 2016

This presentation was recorded at GOTO Copenhagen 2016 http://gotocph.com Simon Brown - Independent Consultant @simonbrown4821 ABSTRACT "We value working software over comprehensive documentation" is what the manifesto for agile software development says, with the typical misinterpretation of these few words being "don't write documentation". Of course, that's not what the manifesto says and "no documentation" certainly wasn't the intent. [...] TIMECODES 0:00 Introduction 3:21 Selected highlights 9:01 Moving fast in the same direction requires good communication 10:51 Why is there a separation between the logical and development views? 11:26 the architecture diagrams don't match the code 16:43 A common set of abstractions is more important than a common notation 17:28 The abstractions must reflect the technology 20:23 Think about the target audience 21:27 C4 is not a design process 21:36 retrospectively drawing diagrams 24:52 What is a "component"? 26:16 The code is the embodiment of the architecture 26:23 Is the architecture in the code? 28:52 Architecture description languages 29:15 Create an architecture description language using code 31:01 "Component Finder" 34:52 Working software comprehensive documentation 35:35 The code doesn't tell the whole story 35:45 Tribal knowledge 39:15 Product project 39:25 Microsoft Word? 43:23 Documentation should describe what the code doesn't 43:35 Tactics for better teams 44:19 The 1990's called and they want their tools back. 45:16 Do you have a ubiquitous language to describe your software? Download slides and read the full abstract here: https://gotocon.com/cph-2016/presentations/show_talk.jsp?oid=7769 RECOMMENDED BOOK Simon Brown • Software Architecture for Developers Vol. 2 • https://leanpub.com/visualising-software-architecture https://twitter.com/GOTOcon https://www.linkedin.com/company/goto- https://www.facebook.com/GOTOConferences #SoftwareArchitecture #C4Model #SimonBrown Looking for a unique learning experience? Attend the next GOTO conference near you! Get your ticket at https://gotopia.tech Sign up for updates and specials at https://gotopia.tech/newsletter SUBSCRIBE TO OUR CHANNEL - new videos posted almost daily. https://www.youtube.com/user/GotoConferences/?sub_confirmation=1