Flujo de Trabajo Detallado para Entregar Tareas en GitHub

Este documento describe el ciclo de vida completo para trabajar en una tarea, desde la sincronización inicial hasta la entrega final mediante un Pull Request.

Resumen del Flujo

Sincronizar: Traer los últimos cambios de la clase (upstream/main) a tu main.
Rama: Crear una rama específica para la tarea (tarea-X) desde main.
Trabajar: Hacer cambios en tu carpeta estudiantes/tu_usuario/.
Subir: Publicar tu rama tarea-X a tu GitHub (origin).
Entregar: Crear un Pull Request desde tu rama tarea-X hacia el main de la clase (upstream).

Automatización con `flow.sh`

Para facilitar este proceso, hemos creado un script que automatiza estos comandos. Consulta la guía completa en: clase/README_FLOW.md

Puedes usarlo con tu LLM:

“Usa el script clase/flow.sh para crear una rama llamada ‘tarea-2’ y sincronizar el repo.”

Paso 1: Actualizar tu repositorio (Sincronización)

Configuración Previa (Solo una vez)

Si es la primera vez que haces esto, necesitas decirle a Git cuál es el repositorio del profesor.

git remote add upstream git@github.com:{org}/{repo-name}.git

Verifica que tengas origin (tu repo) y upstream (mi repo):

git remote -v

Rutina Diaria

Antes de empezar cualquier tarea nueva, debes asegurarte de que tu copia local tiene las últimas diapositivas y ejercicios del profesor.

Abre tu terminal y navega a la carpeta de tu repositorio:
```
cd [ruta_a_tu_repositorio]
```
Muévete a la rama principal:
```
git checkout main
```
Trae los cambios del profesor (upstream) y mézclalos con tu main:
```
git pull upstream main
```
Actualiza tu copia en la nube (origin) para que también esté al día:
```
git push origin main
```

Ahora tu main es idéntico al main del profesor.

Paso 2: Crear una rama para la tarea

Nunca trabajes directamente en main. Crea una rama aislada para tu tarea.

Crea la rama y cámbiate a ella en un solo paso:
```
git checkout -b [nombre-rama-tarea]
```
Ejemplo: git checkout -b tarea-1-intro
Verifica que estás en la rama correcta:
```
git status
```
Debe decir: On branch tarea-1-intro

Paso 3: Trabajar en tu carpeta asignada

⚠️ REGLA DE ORO: Solo puedes modificar archivos dentro de estudiantes/[tu_usuario_de_github]/. Si tocas algo fuera de ahí, tu tarea será rechazada automáticamente.

Navega a tu carpeta personal. Es vital que te muevas a tu carpeta antes de empezar.
```
# Reemplaza 'usuario' con TU usuario de github
cd estudiantes/usuario
```
Verifica dónde estás.
```
pwd
```
Deberías ver algo que termina en .../estudiantes/tu-usuario.
Trabaja:
- Crea archivos nuevos.
- Si creas una carpeta nueva y está vacía, git la ignorará. Para que git la detecte, crea un archivo vacío llamado .gitkeep dentro:
```
touch carpeta-nueva/.gitkeep
```
- Resuelve los ejercicios o copia el código de la clase a tu carpeta.

Paso 4: Guardar cambios (Commit)

Una vez que terminaste una parte del trabajo:

Revisa qué archivos modificaste. Esto te ayuda a evitar subir archivos basura.
```
git status
```
Deberías ver tus archivos en rojo.
Agrega los archivos.
- Peligro: git add . agrega TODO lo que hay en la carpeta actual. Úsalo solo si estás seguro de que estás dentro de tu carpeta personal y no hay archivos basura.
- Mejor opción: Agrega archivos o carpetas específicas:
```
git add archivo.py
# O para una carpeta entera
git add mi-carpeta/
```
Guarda la “foto” de tu trabajo (Commit).
```
git commit -m "Descripción clara de lo que hice"
```
Ejemplo: git commit -m "Terminé el ejercicio 1 de python"

Paso 5: Subir tu rama a GitHub (Push)

Ahora subiremos tu rama tarea-1-intro a TU cuenta de GitHub (conocida como origin). Recuerda: No estás subiendo al repo del profesor, estás subiendo a tu Fork.

Ejecuta el push de la rama específica:
```
git push origin [nombre-rama-tarea]
```
Ejemplo: git push origin tarea-1-intro

Paso 6: Crear el Pull Request (La Entrega)

Aquí es donde oficialmente entregas tu tarea al profesor. Es como enviar el correo con el adjunto, pero versión programador.

Ve a la página de TU Fork en GitHub (https://github.com/TU_USUARIO/NOMBRE_DEL_FORK).
GitHub suele ser inteligente y te mostrará un recuadro amarillo diciendo “Compare & pull request” con tu rama reciente.
- Si no aparece, ve a la pestaña “Pull requests” -> “New pull request”.
- Busca la opción que dice “compare across forks” o asegúrate de que estás comparando repositorios distintos.
Configura la comparación (MUY IMPORTANTE): Asegurate de que la flecha apunte hacia la izquierda (base <- head).
- Base repository: {org}/{repo-name} (Repo del profesor)
- Base branch: main
- Head repository: [tu-usuario]/[tu-fork] (Tu repositorio)
- Compare branch: [nombre-rama-tarea] (La rama donde trabajaste)
⚠️ Error común: No uses tu main en el “compare branch”. Debes seleccionar la rama específica de tu tarea.
Título: [Tarea X] Tu Nombre - Título Breve
Descripción: Explica brevemente qué hiciste o pega el template que te pida la tarea.
Dale click a Create Pull Request.

Paso 7: Limpieza (Post-Entrega)

Una vez que tu tarea fue aceptada (Merges) por el profesor o ya la terminaste.

Regresa a tu main local:
```
git checkout main
```
Trae los cambios nuevos (donde tu tarea ya es parte oficial del historial):
```
git pull upstream main
```
Sincroniza tu main en la nube:
```
git push origin main
```
(Opcional) Borra la rama de la tarea que ya entregaste, pues ya está en main:
```
git branch -d tarea-1-intro
```