Software Architecture Documentation in Agile
Caglar Cakir Fatih Cetin Mustafa Savasci Oğuz Findik
AbstractOver the last decade, agile practices become very popular amongst software development. According to one of the phrases of the Agile Manifesto “Working software over comprehensive documentation” sometimes could lead practitioners to the misunderstanding of “documentation is not valuable” or “not needed at all”. Because of this understanding from software community, agile practitioners do not give enough attention to architectural related documents. However, documentation is also a communication way between people and this communication should be also simple and lean considering agile principles. Commonly used traditional architectural documentation is very comprehensive and detailed. Creation and maintenance of this architectural documentation take too much effort for agile teams. Therefore, existing architectural template documents cannot serve agile teams in the best way. Rather than using existing architectural documents, this article presents a new lightweight architectural documentation template that can be used maintained easily in agile projects.