Technical Writer: A proposal to improve quality and documentation in the agile methodology "Scrum"

Abstract

Software development companies that choose to work with the agile Scrum methodology focus their efforts on frequent product delivery, neglecting the documentation itself of the processes involved in development. Scrum teams are made up of highly trained technicians in whom trust is placed for the development of a software solution. To support the Scrum team in documentation issues, we propose to incorporate a new actor called Technical Writer into the team, who will be in charge from the beginning of carrying the documentation that merits according to the phases of software development, which will contribute to the delivery of a final product with quality and with the respective documentation. We conclude that although the documentation is not the strength of the agile Scrum methodology, it is very necessary to deliver a quality product to its customers.


Resumen. Las empresas  de  desarrollo  de  Software  que  optan  por  trabajar  con la metodología ágil como Scrum, centran sus esfuerzos en la entrega frecuente  y priorizada de productos, descuidando en gran medida la documentación que se genera en sí durante los procesos inmersos en el desarrollo de software. Normalmente, los equipos de Scrum están conformados por técnicos altamente capacitados que  se orientan completamente al desarrollo de una solución software. Para apoyar al equipo Scrum en temas de documentación y elaboración de artefactos de software, proponemos incorporar dentro del equipo a un nuevo actor que lo hemos denominado: “Technical Writer”, quien se encargará de llevar la documentación desde el principio del proceso Scrum y en las actividades donde se amerite en las fases del desarrollo del software. La propuesta apunta a que los técnicos del equipo Scrum aporten de mejor manera en la entrega de un producto final con calidad y con una adecuada documentación. Concluimos que a pesar de que la documentación no es el fuerte de la metodología ágil Scrum, es muy necesaria para entregar un producto de calidad a sus clientes.

References
[1] Christoph Johann Stettina, Werner Heijstek. ``Necessary and Neglected? An Empirical Study of Internal Documentation in Agile Software Development Teams'' ACM 978-1-4503-0936-3/11/10, http://www.liacs.nl/home/{stettina,heijstek}

[2] Michael Coram and Shawn Bohner. `` The Impact of Agile Methods on Software Project Management'' doi: 0-7695-2308-0/05, Department of Computer Science, Virginia Polytechnical Institute and State University, {mcoram, sbohner}@vt.edu

[3] ``SCRUM, it's about Common Sense., https://www.scrum.org/resources/what-isscrum

[4] Julieta Calabrese, Silvia Esponda, Marcos Boracchia, Patricia Pesado ``Hacia una mejora de calidad en Scrum. Integrando documentación requerida por IRAMISO 9001:2015'' Instituto de Investigación en Informática LIDI (III-LIDI), Facultad de Informática -- Universidad Nacional de La Plata, {jcalabrese, sesponda, marcosb, ppesado}@lidi.info.unlp.edu.ar

[5] A. Alliance. 2001 "Agile manifesto," [Online]. Available: http://agilemanifesto.org/ [Accessed 25 05 2017]

[6] D. E. Strode, S. L. Huff, B. Hope, & S. Link, ``Coordination in co-located agile software development projects,'' Journal of Systems and Software, vol. 85, no. 6, pp. 1222–1238, 2012.

[7] J. Highsmith, and A. Cockburn, "Agile software development: The business of innovation," Computer, vol. 34, no. 9, pp.120–127, 2001.

[8] O. P. Timperi, "An overview of quality assurance practices in agile methodologies," In T-76.650 Seminar in Software Engineering, 2004.

[9] A. Cockburn, ``Agile Software Development,'' Boston, MA, USA: Addison-Wesley Longman Publishing Co., Inc., 2002.

[10] P. Abrahamsson, J. Warsta, M. T. Siponen, and J. Ronkainen, ``New directions on agile methods: A comparative analysis,'' In Proceedings of the 25th International Conference on Software Engineering, ser. ICSE '03. Washington, DC, USA: IEEE Computer Society, pp. 244–254, 2003.

[11] ISO. (2015). Sistemas de gestión de la calidad, Fundamentos y vocabulario. Suiza, Ginebra: International Organization for Standardization.