Summary
In this chapter, we have learned the importance of documentation in developing software systems following Agile development methodologies. We have learned the reasons for documentation, why documentation is considered a flow barrier, and some of the challenges associated with traditional documentation methods, such as exceeded budget, no one reading the documentation, the fact that it is a waste of effort, change tolerance, and documentation silos.
Furthermore, we have explored the Lean-Agile documentation and the adoption of evolutionary collaboration as an alternative approach for documentation. We have learned about alternative methods, such as documentation as code, generating documentation, focusing on models, and the use of visual aids. Additionally, this chapter examined the adequacy of documentation and principles for good documentation, such as purpose-driven documentation, consumer-driven documentation, delivering just barely enough documentation, and the timely...