Coevaluación de trabajos
Los archivos de entrega (archivos .py o .zip) están designados por la secuencia de apellidos de los integrantes del grupo responsable en orden alfabético. Cada grupo debe descargar el archivo del grupo que le sigue en forma circular dentro de la carpeta de su curso, y publicar (sólo uno de sus miembros) en este foro un análisis del programa, realizado también en forma colaborativa con su propio grupo.
Deben reportar:
- Si el programa principal o función main() y las funciones tienen los docstrings (secciones declarativas) iniciales describiendo el análisis y el diseño correspondiente: objetivo del programa o contrato de la función (análisis) y reporte de variables (nombre, tipo y para qué se usa -diseño).
- Si las secciones de código del programa y de las funciones están documentadas con comentarios de encabezamiento de subsecciones que anuncian su objetivo o con comentarios de fin de línea explicando lo que resuelven instrucciones significativas o secuencias de instrucciones de estructuras de control. Se debe poder hacer un seguimiento o traza de ejecución de programas y funciones mediante la documentación interna (programación literaria).
- Si las funciones están al comienzo de la sección de código, antes del programa principal o función main(), y antes de cualquier otra función que las invoque.
- Si los nombres de variables son mnemónicos, es decir, claramente indicativos de los valores que representan.
- Si el programa es correcto y completo, es decir, si cumple todas las especificaciones del enunciado con eficacia.
- Si la interfaz del programa es amigable: los resultados deben estar bien presentados y descriptos.
- Si hay una evaluación de resultados, sea mediante documentación interna o impresión en pantalla.
- Si recomiendan una o más cambios para mejorar la legibilidad o la eficiencia del programa o funciones.
Estructurar el reporte enumerando cada uno de los aspectos en el mismo orden en que se presentan e indicando si el programa cumple con la convención y, en caso negativo, indicar los defectos.
En caso de no haber acuerdo en el grupo sobre el cumplimiento de algún aspecto del programa que se está analizando, personalizar las divergencias individualizando qué miembros del grupo corrector opinan en un sentido o en otro.
En caso de que recomienden cambios en el código en atención del punto 8, pueden describirlos como respuesta textual a ese punto o pueden adjuntar el programa revisado con comentarios agregados en forma localizada para indicar los cambios sugeridos.
El límite para completar esta actividad es el 24/4 a las 23:59.