Architectural design and documentation: Waste in agile development?

There is a problem with documentation and architectural design in agile projects. This is the result of interviews we have conducted with 37 software engineering experts from industry and academia. In our paper, we analyze the interview results and the origins of the revealed issues. We propose ways to integrate software design methodologies into agile development, and reputation mechanism to solve documentation problems. The contributions of this paper are (i) an investigation of expert opinions on design and documentation problems, (ii) an analysis of problem origins, and (iii) proposals for future improvements of agile processes.

[1]  Zoya Durdik,et al.  Towards a process for architectural modelling in agile software development , 2011, QoSA-ISARCS '11.

[2]  Pekka Abrahamsson,et al.  Agile methods in European embedded software development organisations: a survey on the actual use and usefulness of Extreme Programming and Scrum , 2008, IET Softw..

[3]  Eirik Tryggeseth,et al.  Report from an Experiment: Impact of Documentation on Maintenance , 1997, Empirical Software Engineering.

[4]  Tore Dybå,et al.  Developing Software with Scrum in a Small Cross-Organizational Project , 2006, EuroSPI.

[5]  Bran Selic,et al.  Agile Documentation, Anyone? , 2009, IEEE Software.

[6]  Barry W. Boehm,et al.  Get Ready for Agile Methods, with Care , 2002, Computer.

[7]  Bhaven Sheth.  Scrum 911! Using Scrum to Overhaul a Support Organization , 2009, 2009 Agile Conference.

[8]  Christian R. Prause,et al.  An approach for continuous inspection of source code , 2008, WoSQ '08.

[9]  Muhammad Ali Babar.  An exploratory study of architectural practices and challenges in using agile software development approaches , 2009, 2009 Joint Working IEEE/IFIP Conference on Software Architecture & European Conference on Software Architecture.

[10]  Christian Prause.  Reputation-based self-management of software process artifact quality in consortium research projects , 2011, ESEC/FSE '11.

[11]  David Garlan,et al.  Documenting software architectures: views and beyond , 2002, 25th International Conference on Software Engineering, 2003. Proceedings..

[12]  Richard P. Gabriel,et al.  Innovation happens elsewhere - open source as business strategy , 2005 .

[13]  Jef Raskin.  Comments are More Important than Code , 2005, ACM Queue.

[14]  Wolfgang Prinz,et al.  Dynamic Self-moderation in a Corporate Wiki to Improve Participation and Contribution Quality , 2011, ECSCW.

[15]  Audun Jøsang,et al.  A survey of trust and reputation systems for online service provision , 2007, Decis. Support Syst..

[16]  Muhammad Ali Babar,et al.  Agility and Architecture: Can They Coexist? , 2010, IEEE Softw..