Guía de trabajo con Git y Forgejo

Esta guía define el flujo de trabajo para realizar cambios en el repositorio de la asignatura.

Flujo de trabajo

Actualizar la rama main antes de comenzar una nueva tarea.
Crear una rama con un nombre descriptivo. Ejemplos:
- actividad/actividad-integradora-01
- docs/mejora-readme
Realizar los cambios únicamente relacionados con la tarea.
Revisar los archivos modificados y ejecutar las validaciones disponibles.
Crear un commit con un mensaje claro y descriptivo.
Publicar la rama en Forgejo.
Crear una pull request hacia main.
Revisar y aprobar la pull request antes de realizar el merge.

Convenciones para ramas

Tipo de cambio	Prefijo recomendado
Actividad integradora	`actividad/`
Documentación	`docs/`
Corrección	`fix/`
Experimento o prueba	`test/`

Convenciones para commits

El mensaje debe indicar claramente qué cambió. Se recomienda utilizar un prefijo seguido de una descripción breve en español.

docs: agrega instrucciones de la actividad 01
feat: implementa formulario de registro
fix: corrige validación del correo electrónico

Revisión antes de publicar

Antes de crear una pull request, comprobar lo siguiente:

La actividad coincide con el enunciado y la rúbrica.
Los cambios incluyen solo archivos relacionados con la tarea.
No se incluyen contraseñas, tokens, archivos .env ni información privada.
El código o los comandos fueron ejecutados cuando corresponda.
La descripción de la pull request explica qué se cambió y cómo se validó.

Merge a `main`

La rama main representa el estado aprobado del repositorio. Por ello, los cambios deben llegar mediante una pull request revisada. El merge se realiza solo después de aprobar el contenido desde Forgejo.