ED

🚀 Conceptos clave en GitHub: Fork, Sincronización y Pull Request

Cuando trabajas con proyectos en GitHub, es común encontrar estos tres conceptos: fork, sincronización y pull request. Vamos a explicarlos en orden lógico para que entiendas cómo funcionan juntos.

🪝 1. Fork (Bifurcación)

Un fork es una copia de un repositorio en tu cuenta de GitHub.
Sirve para modificar y trabajar sobre un proyecto sin afectar el original.

🔹 ¿Para qué se usa?

✅ Contribuir a proyectos open source sin modificar el código original directamente.
✅ Probar cambios en un proyecto antes de proponerlos a los mantenedores del repositorio.
✅ Tener una copia personal de un repositorio que no administras.

🔹 Ejemplo de fork

1️⃣ Encuentras un proyecto interesante en GitHub.
2️⃣ Haces clic en el botón Fork en la parte superior del repositorio.
3️⃣ GitHub crea una copia del repositorio en tu cuenta.
4️⃣ Ahora puedes modificarlo sin afectar el original.

🔄 2. Sincronizar un Fork

Si el repositorio original sigue cambiando con el tiempo, tu fork se queda desactualizado. Para traer los cambios nuevos del original a tu fork, debes sincronizarlo.

🔹 ¿Cómo se hace?

🔘 Desde la web: GitHub tiene un botón “Sync Fork” que sincroniza automáticamente los cambios del original con tu fork.
💻 Desde la terminal: Se usa git fetch upstream y git merge para revisar los cambios antes de fusionarlos.

🔹 Ejemplo de sincronización manual en la terminal:

1️⃣ Configurar el repositorio original como remoto (upstream):

   git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPO.git

2️⃣ Obtener los cambios sin fusionarlos aún:

   git fetch upstream

3️⃣ Aplicar los cambios en tu fork:

   git merge upstream/main

⬆ 3. Pull Request (PR)

Un Pull Request (PR) es una solicitud para que los cambios de tu fork sean añadidos al repositorio original.

🔹 ¿Cómo funciona?

1️⃣ Haces cambios en tu fork (añadir código, corregir errores, mejorar documentación, etc.).
2️⃣ Subes los cambios a GitHub (git push origin rama-nueva).
3️⃣ Creas un Pull Request desde GitHub para pedir que esos cambios se fusionen en el repo original.
4️⃣ Los mantenedores revisan tu PR y deciden si aceptarlo, solicitar cambios o rechazarlo.

🔹 Ejemplo de flujo de trabajo con un PR:

Haces un fork de un proyecto.
Creas una nueva rama en tu fork y realizas cambios.
Subes los cambios y creas un Pull Request en GitHub.
Los mantenedores del repo original revisan tu propuesta y pueden aceptarla o pedir mejoras.

🔥 Resumen: Diferencias clave

🏆 Ejemplo práctico: Contribuyendo a un repositorio en GitHub

1️⃣ Haces un fork de un proyecto que quieres mejorar.
2️⃣ Modificas el código en tu fork (por ejemplo, corriges un error).
3️⃣ Subes tus cambios y creas un Pull Request para que los dueños del repo original los revisen.
4️⃣ Si aceptan tu PR, ¡tus cambios se fusionan en el proyecto original! 🎉

📌 ¿Cuándo usar cada uno?

✅ Hacer un fork → Si quieres modificar un proyecto sin afectar el original.
✅ Sincronizar → Si el proyecto original se ha actualizado y quieres mantener tu fork al día.
✅ Pull Request → Si quieres proponer mejoras al repositorio original.

¿Te queda alguna duda sobre estos conceptos? 🚀