Persisting knowledge with documentation
Working software over comprehensive documentation is one of the Agile manifesto principles that leads to delusions such that Agile projects do not need to be documented at all. Agile development methodologies encourage a relentless focus on delivering value, which often causes the elimination of architecture documentation as it is regarded as a no-value activity.
A closer look at the articulation of the Agile manifesto values indicates that signatories have recognized the value of documentation, but working software has more value. Robert C Martin observed that documentation is not anti-Agile. If it were, then there would not be any Agile books, articles, and blogs.
Jim Highsmith, one of the signatories of the Agile manifesto, warned the developer community that Agile and documentation are not oxymorons. Adequate documentation is essential for the success of Agile software development. Irrespective of the development methodology, since...
