JUG Tirana: Explain your software architecture with arc42

How do you explain your software architecture to fellow developers, management or other stakeholders?
arc42 promises „painless documentation“ - and in this talk Dr. Gernot Starke will show you how that works in practice:

Together we’ll have a look at effective usage of the arc42 documentation and communication template.
We cover several parts by explaining examples, and discuss how to introduce arc42 into your project.

Since more than a decade, the open-source arc42 software architecture documentation template
supports small, medium and large-scale systems around the globe. It has been created by practitioners,
with pragmatism and efficiency in mind. Details on https://arc42.org.

02:30 comparison to building-("skyscraper") architecture
06:54 architecture is more than a diagram
08:17 (rotten) ship in the desert
10:45 six-meter printed diagram... utterly useless
12:31 arc42 to the rescue: template
15:26 overview example "data migration"
18:44 overview example "crm"
21:30 HTMLSanityChecker example
26:35 context and external interfaces
27:58 solution strategy
29:21 building block overview
33:07 runtime view
34:25 deployment view
36:39 cross-cutting concepts - the technical details

40:02 start here: https://arc42.org/overview
42.06 many tips to get you started https://docs.arc42.org