Definition of Done - Academic-Developers/Thinktopia-Plataforma-de-actividades-Academicas GitHub Wiki

✅ Definition of Done (DoD) - Thinktopia Project

Objetivo: Asegurar que cada tarea esté completamente terminada y cumpla con los estándares mínimos de calidad acordados por el equipo de Thinktopia.

Alcance

Este DoD aplica a:

  • Tareas técnicas (TK)

  • Maquetado estático y responsive

  • Correcciones o mejoras

  • Documentación asociada a entregas

Requisitos generales:

Cada tarea (TK) o ítem se considerará “Hecho” solo si cumple con los criterios correspondientes a su tipo, detallados a continuación.

Tareas Técnicas / Desarrollo (código, maquetado, implementación)

  • La tarea está completamente implementada y cumple con la funcionalidad esperada.

  • El código es limpio, legible y sigue las convenciones acordadas (HTML semántico, buenas prácticas en CSS, estructura en Angular/Django si aplica).

  • El código está documentado internamente cuando es necesario (nombres claros, comentarios útiles).

  • La vista o componente es responsive y funciona correctamente en distintos tamaños de pantalla.

  • La aplicación es accesible y cumple con las pautas WCAG 2.1 AA.

  • El HTML y CSS pasan la validación W3C. Se ejecutaron pruebas manuales y funcionales.

  • Se ejecutó Lighthouse y no se obtuvieron valores críticos (<60%) sin justificar.

  • El código está correctamente versionado en Git y tiene mensajes de commit claros, atómicos y con prefijos.

  • Fue revisado por al menos un integrante del equipo (Pull Request o revisión cruzada).

  • El código es mergeable sin conflictos y sigue la estructura de carpetas definida.

Tareas de Documentación (Wiki, DoD, ceremonias, manuales, readme)

  • El contenido está completo, claro y redactado correctamente.

  • Se usó vocabulario técnico apropiado y sin errores gramaticales ni ortográficos.

  • Está alojado en la ubicación correspondiente (Wiki, README).

  • Refleja el estado actual del proyecto a la fecha de entrega.

  • Fue revisado por otro miembro del equipo (QA o revisión cruzada).

  • Se referencia correctamente desde el Readme o la Wiki si es relevante.

Consideraciones y exclusiones

  • Este DoD no incluye pruebas unitarias ni de integración, ya que no están contempladas en esta etapa del proyecto.

  • Algunas tareas pueden depender de datos simulados o estructuras temporales.

  • Si una tarea depende de otra, no se debe cerrar hasta que todas las dependencias estén resueltas.

Última revisión: 2025-05-27