Eficacia en el registro de documentación en equipos de trabajo con desarrollo de software
DOI:
https://doi.org/10.35588/djv1kq31Palabras clave:
Conventional Commits, documentación, versionamientoResumen
El presente artículo de investigación aborda la eficacia de la documentación como un factor crítico pero frecuentemente subestimado para la sostenibilidad de los proyectos de software. Partiendo de la problemática de que muchos proyectos son abandonados por una gestión deficiente y una creciente complejidad técnica, este estudio se propuso cuantificar objetivamente las prácticas de documentación y versionamiento en un equipo de desarrollo de una institución financiera. La investigación se fundamenta en un marco teórico que conecta la claridad del código, las metodologías ágiles y el control de versiones con la productividad del equipo y la viabilidad del proyecto a largo plazo. La metodología empleada consistió en un análisis cuantitativo y empírico, utilizando un script automatizado para examinar 1,294 commits de cuatro repositorios de software críticos durante el segundo trimestre de 2025. El instrumento midió la adherencia al estándar de Conventional Commits como un indicador de la calidad y disciplina en la documentación de cambios. Los resultados revelaron una baja tasa de cumplimiento consolidada de solo 24.34%, evidenciando una brecha significativa entre las buenas prácticas recomendadas y su aplicación real.
Descargas
Referencias
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
Descargas
Enviado
2025-08-22Publicado
Número
Sección
Licencia
Derechos de autor 2026 Revista Gestión de las Personas y Tecnología
Esta obra está bajo una licencia internacional Creative Commons Atribución 4.0.
