Tag: documentation

SE-Radio Episode 244: Gernot Starke on Architecture Documentation using arc42

Filed in Episodes by on December 16, 2015 2 Comments
SE-Radio Episode 244: Gernot Starke on Architecture Documentation using arc42

Gernot Starke talks about arc42: an open-source set of templates he developed to document software architecture based on his practical experience with real projects. Also Gernot and host Eberhard then discuss how documenting architecture fits into agile processes and how to find the right amount of documentation for a system. They walk through the different […]

Continue Reading »

Episode 228: Software Architecture Sketches with Simon Brown

Filed in Episodes by on June 11, 2015 3 Comments
Episode 228: Software Architecture Sketches with Simon Brown

Simon Brown, author of Software Architecture for Developers, talks with Sven Johann¬†about using simple sketches to visualize, communicate and document software architecture. The show starts with a consideration of why sketches are more useful than UML and then continues with the explanation of the C4 model (context, containers, components and classes) and how it fits […]

Continue Reading »

Episode 31: Agile Documentation

Filed in Episodes by on October 3, 2006 1 Comment
Episode 31: Agile Documentation

In this episode, our guest Andreas Rueping and Markus talk about documenting software. While this is a topic that many people don’t like or consider fun, it is nonetheless very important. Based on his book, Agile Documentation, we talk about various aspects documenting software such as what to document, when to document, which media to use as well as specifically a number of layouting tips for nice documents.

Continue Reading »