Deuda de la documentación en el desarrollo ágil de software: mapeo sistemático de la literatura

Español; castellano. Resumen En el desarrollo de software, la documentación es un proceso continuo en el cual se especifica qué hace el sistema, cómo lo hace y para quién lo hace, describiendo todas sus características desde diferentes perspectivas para facilitar la comprensión de todos los interesados. Sin embargo, esto no siempre se logra, debido a malas prácticas de documentación, lo cual lleva a un tipo de deuda técnica conocida como deuda de la documentación, relacionada con documentación faltante, inconsistente o incompleta que degrada la comprensión del sistema, afectando gravemente su desarrollo, mantenimiento y evolución. Este fenómeno parece agravarse en los enfoques ágiles, ya sea por una mala interpretación de los valores y principios ágiles, enfocándose en la entrega continua de software funcional más que en la documentación exhaustiva, o por desconocimiento de buenas prácticas de documentación. Si bien existen iniciativas que describen de forma general las causas, efectos y buenas prácticas para mitigar la deuda de documentación, aún hace falta comprender el impacto de este tipo de deuda para la industria de software y profundizar en una definición más completa en el desarrollo ágil de software. En ese sentido, se presentan los resultados de un mapeo sistemático que brinda una base sólida de conocimiento sobre la deuda de la documentación en el desarrollo ágil de software y permite identificar brechas u oportunidades de investigación en este tema.

Inglés. Abstract In software development, documentation is a continuous process that specifies what the system does, how it does it, and for whom it does it, describing all its characteristics from different perspectives in order to facilitate the understanding of all the interested parties. However, this is not always achieved due to poor documentation practices, leading to a type of technical debt known as documentation debt, which is related to missing, inconsistent, or incomplete documentation that degrades the understanding of the system, severely affecting its development, maintenance, and evolution. This phenomenon seems to be aggravated in agile approaches, either due to a misunderstanding of agile values ​​and principles by focusing on the continuous delivery of functional software rather than comprehensive documentation, or a lack of good documentation practices. Although there are initiatives that generally describe the causes, effects, and good practices to mitigate documentation debt, it is still necessary to understand the impact of this type of debt on the software industry and to delve into a more complete definition in agile software development. In this sense, the results of a systematic mapping are presented, which provide a solid base of knowledge about documentation debt in agile software development and allow identifying gaps or research opportunities in this topic.

Portugués. Resumo No desenvolvimento de software, a documentação é um processo contínuo em que se especifica o que o sistema faz, como faz e para quem faz, descrevendo todas as suas características sob diferentes perspectivas para facilitar o entendimento de todos os interessados. No entanto, isso nem sempre é alcançado devido às más práticas de documentação, levando a um tipo de dívida técnica conhecida como dívida de documentação relacionada à documentação ausente, inconsistente ou incompleta que degrada a compreensão do sistema, afetando severamente seu desenvolvimento, manutenção e evolução. Esse fenômeno parece ser agravado nas abordagens ágeis, seja por uma incompreensão dos valores e princípios ágeis, com foco na entrega contínua de software funcional em vez de documentação abrangente, ou pela falta de boas práticas de documentação. Embora existam iniciativas que geralmente descrevem as causas, efeitos e boas práticas para mitigar a dívida de documentação, ainda é necessário entender o impacto desse tipo de dívida para a indústria de software e aprofundar uma definição mais completa em desenvolvimento ágil. . Nesse sentido, são apresentados os resultados de um mapeamento sistemático que fornece uma base sólida de conhecimento sobre a dívida de documentação no desenvolvimento ágil de software e permite identificar lacunas ou oportunidades de pesquisa neste tema.