Guia para changelog

[ssinuco]

Elaborar una guia para que las estudiantes agreguen un changelog a los repositorios de sus proyectos con los siguientes objetivos:

• Que las estudiantes identifiquen los avances sprint a sprint del proyecto
• Que las estudiantes identifiques los aprendizajes sprint a sprint del proyecto
• Que las estudiantes evalúen la calidad y utilidad de los mensajes de tus commits

---

Prepare um guia para os alunos adicionarem um changelog aos repositórios de seus projetos com os seguintes objetivos:

• Peça aos alunos que identifiquem o progresso sprint por sprint do projeto
• Que os alunos identifiquem os aprendizados sprint a sprint do projeto
• Peça aos alunos que avaliem a qualidade e a utilidade das suas mensagens de commit

[ssinuco]

• Discutir si esto deberia agregarse a los proyectos de Core o solo a los de Etapa de Rutas o a ambos. Tambien se debe discutir como integrar la revision de estos changelog al dia a dia de las coaches y si podemos automatizar en algo esta revision.
• Elaborar guia @ssinuco
• Review guia
• Traduccion guia Portugues

[ssinuco]

@merunga @marianaLz @unjust Abro la discusion en Github sobre la inclusion de changelog en los repositorios de las estudiantes.

Hace meses Sebastian habia sugerido que podria ser buena idea pedirles a las estudiantes que incluyeran un changelog en su proyecto. Yo estuve de acuerdo porque veia que al elaborar un changelog las estudiantes podian reflexion mejor sobre sus avances y aprendizajes. Por lo que elaboré una guia y le recomendé a las estudiantes de Etapa de Rutas que la usaran para crear changelog en sus proyectos. Como era una recomendacion la gran mayoria no las agrego. Pero algunas de ellas si fueron muy juiciosas, les pongo los links de algunos ejemplos:

• https://github.com/ginapedraza/DEV010-burger-queen-api-client/blob/main/CHANGELOG.md
• https://github.com/KarinaMirandaRuiz/DEV011-fleet-management-api/blob/main/CHANGELOG.md
• https://github.com/LorenaBarr/DEV010-movie-challenge-fw-Lo/blob/filtrado-ordenado-HU2/CHANGELOG.md

Revisando estos ejemplo, creo que el experimento funciono. Los Changelog son detallados en cuanto al avance y aprendizajes.

Entonces, quiero discutir con ustedes las siguientes preguntas:

• ¿Agregar un changelog al repo deberia ser obligatorio o no?
• ¿Deberíamos agregar esta guia en los READMES de los proyectos core o proyectos de etapa de ruta o ambos?
• ¿Como podemos incluir la revision de estos changelog en el dia a dia de las coaches? ¿Esta revision podra ser automatizada?

[marianaLz]

Me encanta la idea, creo que esto podría ser desde el Core y yo pensaría que obligatorio, es estarles forzando a usar y entender un commit y algunas cosas de github...