Lineamientos para la entrega final y la presentación

Lineamientos para la entrega final y la presentación

de Javier Schandy -
Número de respuestas: 1

Con el objetivo de guiarlos en el desarrollo de un proyecto excelente, confeccionamos la siguiente lista de puntos deseables para cada una de las instancias finales del proyecto. 

Los componentes que se evalúan en el proyecto son:

  • Documentación
  • Base de código
  • Presentación oral final (incluyendo demo)
  • Ejecución de proyecto
A continuación se detalla una lista de recomendaciones para cada una de los componentes.

  • Documentación
    • La documentación debe incluir una introducción clara al problema, suficiente sin un contexto anterior. Se deben describir antecedentes suficientes
    • Los objetivos del proyecto deben estar explicados claramente.
    • El alcance del proyecto debe quedar claro, sin ambigüedades respecto a lo que cubre y a lo que no cubre
    • La solución debe estar descrito de forma detallada.
    • Las pruebas y medidas deben estar debidamente reportadas, en caso que corresponda.
    • Conclusiones
      • Ausencia de conclusiones genéricas ("Funcionamos bien como grupo", "Profundizamos sobre los conceptos de la asignatura")
      • Análisis independiente y detallado frente a los objetivos del proyecto.
      • Es deseable contar con un análisis en cuanto a la dedicación planificada
    • Otros elementos de documentación
      • Documento bien estructurado
      • Buenas imágenes, en un estilo armonioso
      • Anexos conceptualmente correctos. No deben adjuntar secciones importantes a los anexos, ni viceversa
      • Caratula correcta, sin faltas de ortografía
  • Base de código
    • El repositorio debe incluir un README.md que guía al lector en sus primeros pasos con el proyecto.
    • El directorio del proyecto debe incluir solamente archivos fuente nuevos o modificados (no incluir el repositorio de contiki-ng). No binarios, .elf, etc
    • No deben haber constantes sueltas en el código. Idealmente todo valor "duro" se define mediante un define
    • Indentación correcta
  • Presentación oral final
    • La presentación debe permitir entender la esencia del proyecto y el grado de completitud de los objetivos
    • Deben cumplir estrictamente con las restricciones de tiempo.
    • La presentación oral debe ir acompañada de buenas diapositivas: 
      • Poco texto, orientado a los conceptos fundamentales.
      • Lo que se dice no es exactamente lo que está escrito en las diapositivas.
      • Buenas imágenes, en una escala correcta (visible).
      • Buen contraste de color. Recuerden que las diapositivas con fondo oscuro no se ven bien en los proyectores.
      • Buen estilo gráfico.
    • Todos los integrantes deben participar en proporción similar.
    • Se debe evidenciar que todos los integrantes dominan la totalidad del proyecto.
    • La presentación debe ser dinámica y fácil de seguir.

  • Demo en vivo
    • Es una demostración práctica/técnica donde se muestra el funcionamiento global del sistema, y además permite apreciar los detalles más relevantes.
    • Tiene una duración máxima 5 minutos y es dinámico.
    • Explica con una diapositiva las generalidades del proyecto necesarias para entender el demo.
    • Muestra el sistema en funcionamiento.
    • Muestra el caso de "uso normal", y capaz otros no tan normales (incluso puede mostrar casos no contemplados). 
    • Muestra bien el setup, la interacción con el usuario o con otros equipos cuando la haya,
    • Muestra la configuración del sistema y su interfaz.
    • Permite observar que el proyecto funciona correctamente, y no levanta suspicacias sobre bugs escondidos.

En respuesta a Javier Schandy

Re: Lineamientos para la entrega final y la presentación

de Javier Schandy -
Estimados, luego de discutirlo entre los docentes decidimos editar el mensaje anterior, simplificando algunas pautas. Por favor vuelvan a leerlo con atención, y cualquier consulta nos avisan.