Efecto del uso de Javadoc en la comprensibilidad del código fuente en proyectos de desarrollo de software.

Abstract

La documentación del código fuente es un aspecto esencial en el desarrollo de software, ya que impacta directamente en la comprensibilidad, mantenibilidad y eficiencia del trabajo en equipo. En este sentido, JavaDoc se ha consolidado como una herramienta clave en la documentación de proyectos en Java, permitiendo estructurar la información sobre clases, métodos y parámetros. Sin embargo, su implementación aún enfrenta diversos desafíos, como la inconsistencia en la actualización, la resistencia de los desarrolladores a su uso y la falta de estandarización en su aplicación. El objetivo de esta investigación es determinar el impacto del uso de JavaDoc en la comprensibilidad del código fuente en proyectos de software desarrollados durante el año 2024. Para ello, se empleó una metodología de investigación mixta, que combinó encuestas, entrevistas y análisis de proyectos documentados y no documentados con JavaDoc. Los resultados obtenidos revelan que la implementación de JavaDoc reduce significativamente el tiempo necesario para comprender el código y mejora la precisión en la interpretación de funcionalidades, lo que se traduce en una mayor eficiencia en el mantenimiento del software. A partir de estos hallazgos, se recomienda la adopción de buenas prácticas en la documentación con JavaDoc, incluyendo la capacitación de los desarrolladores y la implementación de estándares para su uso. Asimismo, se sugiere la integración de JavaDoc en el currículo de formación en desarrollo de software para mejorar la preparación de los futuros profesionales del sector.