Becoming an Agile Software Architect

Chapter 10: Lean Documentation through Collaboration

For the most part, things never get built the way they were drawn.

– Maya Lin, designer of 'A Fold in the Field', a sculpture park in Auckland

The previous chapter covered technical agility and different pillars contributing to technical agility, such as patterns and techniques, DevOps and continuous delivery, and built-in quality. This chapter advances to documentation, one of the most debated topics in Agile, and reviews various documentation aspects with a specific focus on delivering architecture artifacts.

Amateur Agile teams treat documentation as a no value-added activity. While excessive documentation creates flow impediments, little documentation can have severe consequences in terms ...