Effectiveness in documentation recording in software development work environments
DOI:
https://doi.org/10.35588/djv1kq31Keywords:
Conventional Commits, documentation, versioningAbstract
This research article addresses the effectiveness of documentation as a critical but frequently underestimated factor for the sustainability of software projects. Starting from the premise that many projects are abandoned due to deficient management and increasing technical complexity, this study aimed to objectively quantify documentation and versioning practices within a work team engaged in software development at a financial institution. The research is grounded in a theoretical framework that connects code clarity, agile methodologies, and version control with team productivity and long-term project viability. The methodology consisted of a quantitative and empirical analysis, using an automated script to examine 1,294 commits from four critical software repositories during the second quarter of 2025. The instrument measured adherence to the Conventional Commits standard as an indicator of quality and discipline in change documentation. The results revealed a low consolidated compliance rate of only 24.34%, evidencing a significant gap between recommended best practices and their actual application.
Downloads
References
Acosta-Bravo, E. (2019). Documentación y adopción de buenas prácticas para el desarrollo de software basado en los fundamentos DevOps. Tesis de Grado. Universidad de Antioquia. https://bibliotecadigital.udea.edu.co/entities/publication/d648b494-ca93-4d6d-8ecf-680febd2b19d
Ait, A., Cánovas-Izquierdo, J. y Cabot, J. (2022). An Empirical Study on the Survival Rate of Github Projects. 19th International Conference on Mining Software Repositories (MSR '22). Association for Computing Machinery. New York, USA. DOI: https://doi.org/10.1145/3524842.3527941
Álvarez-Fuentes, F. (2025). Sistema de documentación de desarrollo de software y seguimiento de proyectos. Proyecto de Graduación. Universidad Tecnológica Centroamericana, Honduras. Centro Universitario Tecnológico CEUTEC. https://repositorio.unitec.edu/items/d3427f49-d5d5-4ff7-b52f-295a1bdfcc53
Aponte, G. M. (2024). Tendencias en la producción científica en el área de tecnologías digitales y economía circular. Revista Gestión de las Personas y Tecnología, 17(49). DOI: https://doi.org/10.35588/6436n243
Ávila-Guerrero, F., Bernal-Díaz, I. y Monroy-Gómez, D. (2023). Transformación Digital Empresarial: Revisión de producciones investigativas 2017 – 2021. Revista Venezolana de Gerencia, 28(101), 282-296. DOI: https://doi.org/10.52080/rvgluz.28.101.18
Castillo-Rodríguez, J. (2023). Impacto del trabajo remoto en los empleados que viven en el estado de Nuevo León, México. Revista Gestión de las Personas y Tecnología, 16(46), 75-93. DOI: https://doi.org/10.35588/5p23qk96
Chakraborty, S. y Aithal, P. (2022). A Practical Approach to GIT Using Bitbucket, GitHub and SourceTree. International Journal of Applied Engineering and Management Letters (IJAEML), 6(2). DOI: https://doi.org/10.5281/zenodo.7262771
Conventional Commits. (2023). Conventional Commits 1.0.0: A specification for adding human and machine-readable meaning to commit messages. Conventional Commits. https://www.conventionalcommits.org/en/v1.0.0/
Espinoza-Calderón, P. (2025). Competencias desarrolladas en el proceso de optimización de pruebas de software en la empresa Globant. Tesis. Universidad Continental, Perú. Repositorio Institucional Continental. https://repositorio.continental.edu.pe/handle/20.500.12394/17277
Gracia-Orejuela, K. (2022). Propuesta de implementación de un proceso de despliegue automatizado, previo pruebas y análisis de código automatizado. Tesis. Pontificia Universidad Católica del Ecuador, Ecuador. https://repositorio.puce.edu.ec/handle/123456789/38149
Guerrero-Calvache, D. y Hernández, E. (2023). Un estudio exploratorio de las percepciones de productividad en equipos de software ágil. TecnoLógicas, 26(56). 1-19. https://doi.org/10.22430/22565337.2625
Leones-Zambrano, W. Macias-Bazurto, L. Pilla-Zuniga, W. y Fernández-Sánchez, E. (2024). Diseño Estratégico de APIs Escalables y Seguras para la Integración de Sistemas y Aplicaciones. Ciencia Latina Revista Científica Multidisciplinar, 8(5), 13395-13408. DOI: https://doi.org/10.37811/cl_rcm.v8i5.14794
Li, J. y Ahmed, I. (2023). Commit Message Matters: Investigating Impact and Evolution of Commit Message Quality. IEEE/ACM 45th International Conference on Software Engineering (ICSE). Melbourne, Australia. DOI: https://doi.org/10.1109/ICSE48619.2023.00076
Pastrana-Pardo, M., Ordoñez-Erazo, H. y Cobos-Lozada, C. (2022). Teaching Guide for Beginnings in DevOps and Continuous Delivery in AWS Focused on the Society 5.0 Skillset. IEEE Revista Iberoamericana de Tecnologías del Aprendizaje, 17(4). DOI: https://doi.org/10.1109/RITA.2022.3217172
Ma, I. y Lopes, C. (2023). Improving the Quality of Commit Messages in Students' Projects. Preprint. arXiv preprint arXiv:2304.13887. DOI: https://doi.org/10.48550/arXiv.2304.13887
Nurlanuly, M., Araz, Z. y Zhuldyz, A. (2025). Analysis the impact of code documentation styles on collaborative software development. Universum: технические науки, 5(134). https://cyberleninka.ru/article/n/analysis-the-impact-of-code-documentation-styles-on-collaborative-software-development
Pachacama-Granda, M., Morales-Cazar, J., Vera-Toscano, E. y Pallo-Morales, J. (2024). Desarrollo de un prototipo funcional para la gestión del sistema de archivos institucionales EPN utilizando metodologías ágiles. (Trabajo de Integración Curricular). Escuela Politécnica Nacional, Ecuador. https://bibdigital.epn.edu.ec/handle/15000/25539
Peng, S., Kalliamvakou, E., Cihon, P. y Demirer, M. (2023). The Impact of AI on Developer Productivity: Evidence from GitHub Copilot. Preprint. arXiv preprint arXiv:2302.06590. DOI: https://doi.org/10.48550/arXiv.2302.06590
Hoda, R., Norsaremah, S. y Grundy, J. (2018). The Rise and Evolution of Agile Software Development. IEEE Software, 35(5). DOI: https://doi.org/10.1109/MS.2018.290111318
Rozo-Rodríguez, M., Casanovas, I. y Pollo-Cattaneo, M. (2020). Ontología para Transferir Conocimiento en la Etapa de Pruebas de Software. Revista Gestión de las Personas y Tecnología, 13(39), 24. DOI: https://doi.org/10.35588/t7krxv27
Slama, F., Ismail, I. y Latrach, L. (2023). Exploring the Integration of Machine Learning Models in Programming Languages on GitHub: Impact on Compatibility to Address Them. Preprint (versión 1). Research Square. DOI: https://doi.org/10.21203/rs.3.rs-2591510/v1
Zeng, Q., Zhang, Y., Qiu, Z. y Liu, H. (2025). A first look at Conventional Commits Classification. En IEEE/ACM 47th International Conference on Software Engineering (ICSE). Ottawa, Canada. DOI: https://doi.org/10.1109/ICSE55347.2025.00011
Qin, Z., Zhang, H., Qin, X., Xu, K., Dimitrov, K. N. A., Wang, G. y Yu, W. (2018). The Development of Software. En Fundamentals of Software Culture. Springer, Singapore. DOI: https://doi.org/10.1007/978-981-13-0701-0_2
Downloads
Submitted
2025-08-22Published
Issue
Section
License
Copyright (c) 2026 People and Technology Management Journal
This work is licensed under a Creative Commons Attribution 4.0 International License.
