Eficácia no registro de documentação em equipes de desenvolvimento de software
DOI:
https://doi.org/10.35588/djv1kq31Palavras-chave:
Conventional Commits, documentação, versionamentoResumo
O presente artigo de pesquisa aborda a eficácia da documentação como um fator crítico, mas frequentemente subestimado, para a sustentabilidade de projetos de software. Partindo da problemática de que muitos projetos são abandonados devido a uma gestão deficiente e à crescente complexidade técnica, este estudo propôs-se a quantificar objetivamente as práticas de documentação e versionamento em uma equipe de trabalho com desenvolvimento de software de uma instituição financeira. A pesquisa fundamenta-se em um arcabouço teórico que conecta a clareza do código, as metodologias ágeis e o controle de versões com a produtividade da equipe e a viabilidade do projeto a longo prazo. A metodologia empregada consistiu em uma análise quantitativa e empírica, utilizando um script automatizado para examinar 1.294 commits de quatro repositórios de software críticos durante o segundo trimestre de 2025. O instrumento mediu a aderência ao padrão Conventional Commits como um indicador da qualidade e disciplina na documentação de mudanças. Os resultados revelaram uma baixa taxa de conformidade consolidada de apenas 24,34%, evidenciando uma lacuna significativa entre as boas práticas recomendadas e sua aplicação real.
Downloads
Referências
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, Colombia. 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). Av 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
Hoda, R., Salleh, N. 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
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
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
Publicado
Edição
Secção
Licença
Direitos de Autor (c) 2026 Revista Electrónica Gestión de las Personas y Tecnología
Este trabalho encontra-se publicado com a Licença Internacional Creative Commons Atribuição 4.0.
