Title: Unidad 4: Pull Request (PR)
Course: 2025 - LISI/LI - Desarrollo de Software Avanzado > Section: Github

🎯 Objetivo

Comprender qué es un Pull Request (PR) en GitHub, cómo se utiliza para integrar cambios entre ramas y por qué es una herramienta clave para colaborar en proyectos.

📘 1️⃣ Qué es un Pull Request

Un Pull Request (PR) es una solicitud para fusionar los cambios realizados en una rama hacia otra (por lo general, hacia la rama principal main).
Sirve para que otros miembros del equipo revisen el código antes de integrarlo, asegurando que no se rompa el proyecto.

💡 Ejemplo:
Imagina que creas una rama llamada feature/login.
Cuando terminas de programar el inicio de sesión, haces un PR para pedir que esos cambios se agreguen a main.
Tu equipo puede revisar el código, comentar, aprobar o solicitar cambios antes de aceptar la fusión.

🔧 2️⃣ Cómo crear un Pull Request

Después de subir tu rama a GitHub, puedes abrir un PR desde la página del repositorio:

1. Ve a la pestaña Pull requests.
2. Haz clic en “New pull request”.
3. Selecciona la rama base (main) y la rama que quieres fusionar (por ejemplo, feature/login).
4. Agrega un título y una descripción que expliquen los cambios realizados.
5. Da clic en “Create pull request”.

Tu PR quedará abierto para revisión y comentarios antes de fusionarse.

🤝 3️⃣ Flujo de trabajo típico

1. Crear una rama → feature/nueva-funcion
2. Hacer los cambios y commits necesarios
3. Subir la rama a GitHub → git push origin feature/nueva-funcion
4. Abrir un Pull Request hacia main
5. Esperar la revisión o aprobación
6. Fusionar el PR una vez aprobado (botón “Merge Pull Request”)

🧠 4️⃣ Ventajas del uso de PR

- Permite revisar el código antes de unirlo al proyecto principal.
- Facilita el trabajo colaborativo (cada quien aporta sin romper main).
- Guarda el historial de discusiones y comentarios sobre cada cambio.
- Detecta conflictos entre ramas antes de fusionar.

💬 Ejemplo práctico

Supón que trabajas en el repositorio:
👉 https://github.com/erick-sv/github-training

1. Creas una rama llamada feature-agregar-footer
2. Modificas un archivo y haces commit
3. Subes tu rama y creas un Pull Request para fusionarla con main
4. Otro compañero revisa, comenta y aprueba el cambio
5. Una vez aceptado, el PR se fusiona y el cambio aparece en la rama principal

🎯 Objetivo

Comprender qué es un Pull Request (PR) en GitHub, cómo se utiliza para integrar cambios entre ramas y por qué es una herramienta clave para colaborar en proyectos.

📘 1️⃣ Qué es un Pull Request

Un Pull Request (PR) es una solicitud para fusionar los cambios realizados en una rama hacia otra (por lo general, hacia la rama principal main).
Sirve para que otros miembros del equipo revisen el código antes de integrarlo, asegurando que no se rompa el proyecto.

💡 Ejemplo:
Imagina que creas una rama llamada feature/login.
Cuando terminas de programar el inicio de sesión, haces un PR para pedir que esos cambios se agreguen a main.
Tu equipo puede revisar el código, comentar, aprobar o solicitar cambios antes de aceptar la fusión.

🔧 2️⃣ Cómo crear un Pull Request

Después de subir tu rama a GitHub, puedes abrir un PR desde la página del repositorio:

1. Ve a la pestaña Pull requests.
2. Haz clic en “New pull request”.
3. Selecciona la rama base (main) y la rama que quieres fusionar (por ejemplo, feature/login).
4. Agrega un título y una descripción que expliquen los cambios realizados.
5. Da clic en “Create pull request”.

Tu PR quedará abierto para revisión y comentarios antes de fusionarse.

🤝 3️⃣ Flujo de trabajo típico

1. Crear una rama → feature/nueva-funcion
2. Hacer los cambios y commits necesarios
3. Subir la rama a GitHub → git push origin feature/nueva-funcion
4. Abrir un Pull Request hacia main
5. Esperar la revisión o aprobación
6. Fusionar el PR una vez aprobado (botón “Merge Pull Request”)

🧠 4️⃣ Ventajas del uso de PR

- Permite revisar el código antes de unirlo al proyecto principal.
- Facilita el trabajo colaborativo (cada quien aporta sin romper main).
- Guarda el historial de discusiones y comentarios sobre cada cambio.
- Detecta conflictos entre ramas antes de fusionar.

💬 Ejemplo práctico

Supón que trabajas en el repositorio:
👉 https://github.com/erick-sv/github-training

1. Creas una rama llamada feature-agregar-footer
2. Modificas un archivo y haces commit
3. Subes tu rama y creas un Pull Request para fusionarla con main
4. Otro compañero revisa, comenta y aprueba el cambio
5. Una vez aceptado, el PR se fusiona y el cambio aparece en la rama principal