Mejorando la legibilidad de los comentarios de software utilizando el puntaje de facilidad de lectura de Flesch
Autores: Eleyan, Derar; Othman, Abed; Eleyan, Amna
Idioma: Inglés
Editor: MDPI
Año: 2020
Acceso abierto
Artículo científico
2020
Mejorando la legibilidad de los comentarios de software utilizando el puntaje de facilidad de lectura de Flesch
Categoría
Gestión y administración
Subcategoría
Gestión de la tecnología y la inovación
Palabras clave
Comentarios
Legibilidad
Programadores
Herramienta
Comprensibilidad
Nivel de legibilidad
Licencia
CC BY-SA – Atribución – Compartir Igual
Consultas: 1
Citaciones: Sin citaciones
Los comentarios se utilizan para explicar el significado del código y facilitar la comunicación entre los propios programadores, los auditores de calidad y los revisores de código. Se ha desarrollado una herramienta para ayudar a los programadores a escribir comentarios legibles y medir su nivel de legibilidad. Se utiliza para mejorar la legibilidad del software al proporcionar alternativas tanto a palabras clave como a declaraciones de comentarios de una base de datos local y un diccionario en línea. También es un motor de búsqueda de palabras para desarrolladores. El nivel de legibilidad se mide utilizando tres fórmulas diferentes: el índice de niebla, el puntaje de facilidad de lectura de Flesch y los niveles de grado de Flesch-Kincaid. Se ha distribuido un cuestionario a 42 programadores y 35 estudiantes para comparar el aspecto de legibilidad entre los nuevos comentarios escritos por la herramienta y los comentarios originales escritos por programadores y desarrolladores anteriores. Los programadores afirmaron que los comentarios de la herramienta propuesta tenían menos palabras complejas y tomaban menos tiempo para leer y entender. Sin embargo, esto no afectó significativamente la comprensibilidad del texto, ya que los programadores normalmente tienen un nivel de inglés bastante alto. Sin embargo, los resultados de los estudiantes muestran que la herramienta afecta la comprensibilidad del texto y el tiempo que se tarda en leerlo, mientras que los resultados de complejidad del texto muestran que la herramienta genera un nuevo texto de comentarios que es más legible al cambiar las tres variables estudiadas.
Descripción
Los comentarios se utilizan para explicar el significado del código y facilitar la comunicación entre los propios programadores, los auditores de calidad y los revisores de código. Se ha desarrollado una herramienta para ayudar a los programadores a escribir comentarios legibles y medir su nivel de legibilidad. Se utiliza para mejorar la legibilidad del software al proporcionar alternativas tanto a palabras clave como a declaraciones de comentarios de una base de datos local y un diccionario en línea. También es un motor de búsqueda de palabras para desarrolladores. El nivel de legibilidad se mide utilizando tres fórmulas diferentes: el índice de niebla, el puntaje de facilidad de lectura de Flesch y los niveles de grado de Flesch-Kincaid. Se ha distribuido un cuestionario a 42 programadores y 35 estudiantes para comparar el aspecto de legibilidad entre los nuevos comentarios escritos por la herramienta y los comentarios originales escritos por programadores y desarrolladores anteriores. Los programadores afirmaron que los comentarios de la herramienta propuesta tenían menos palabras complejas y tomaban menos tiempo para leer y entender. Sin embargo, esto no afectó significativamente la comprensibilidad del texto, ya que los programadores normalmente tienen un nivel de inglés bastante alto. Sin embargo, los resultados de los estudiantes muestran que la herramienta afecta la comprensibilidad del texto y el tiempo que se tarda en leerlo, mientras que los resultados de complejidad del texto muestran que la herramienta genera un nuevo texto de comentarios que es más legible al cambiar las tres variables estudiadas.