Curso de Git y GitHub

COMPARTE ESTE ARTÍCULO Y MUESTRA LO QUE APRENDISTE

Introducción

Trabajar con Git y Pull Requests (PR) permite colaborar de forma segura en proyectos compartidos sin afectar directamente la rama principal del repositorio.

Conceptos principales

¿Qué es una rama de trabajo?

Una rama de trabajo es una copia aislada del código donde puedes realizar cambios sin afectar la rama principal.

main
 └── feature/ISSUE-123

¿Qué es un Pull Request?

Un Pull Request es una solicitud para que tus cambios sean revisados antes de integrarse en una rama de destino.

Principios básicos del flujo

Revisar el estado del repositorio.
Actualizar información del repositorio remoto.
Crear una rama de trabajo desde la rama base.
Desarrollar y probar los cambios.
Crear commits claros y descriptivos.
Publicar la rama.
Abrir un Pull Request.
Atender revisiones e integrar cuando corresponda.

Pasos o instrucciones

Paso 1: Verificar el repositorio

git rev-parse --show-toplevel
git branch --show-current
git status --short --branch

Paso 2: Actualizar referencias remotas

git fetch origin
git status --short --branch
git branch -vv

Paso 3: Actualizar la rama base y crear una rama de trabajo

git switch main
git pull --ff-only origin main

git switch -c feature/ISSUE-123 origin/main

Paso 4: Desarrollar y crear commits

git status
git diff
git diff --check

git add src/archivo.ext
git add tests/archivo_test.ext

git diff --staged

git commit -m "ISSUE-123: describe el cambio"

Paso 5: Publicar la rama

git push -u origin feature/ISSUE-123

Paso 6: Crear el Pull Request

Selecciona la rama de origen.
Selecciona la rama destino.
Describe claramente el objetivo.
Explica cómo probar los cambios.
Asigna revisores si aplica.

Paso 7: Atender comentarios de revisión

git add <archivos>
git commit -m "ISSUE-123: atiende comentarios de revisión"
git push

Paso 8: Integrar y sincronizar

git fetch origin
git switch main
git pull --ff-only origin main

git branch -d feature/ISSUE-123

Ejemplos prácticos

Escenario: corregir un error

git switch main
git pull --ff-only origin main
git switch -c fix/ISSUE-234-error-login origin/main

git add src/login.js
git commit -m "ISSUE-234: corrige validación de acceso"

git push -u origin fix/ISSUE-234-error-login

Ejemplo de descripción de Pull Request

Objetivo:
Corregir validación incorrecta en el formulario de acceso.

Cómo probar:
1. Abrir pantalla de login.
2. Ingresar credenciales válidas.
3. Confirmar acceso exitoso.

Buenas prácticas y recomendaciones

✅ Haz esto

Revisa siempre el estado con git status.
Mantén las ramas pequeñas y enfocadas.
Crea commits con un único propósito.
Ejecuta pruebas antes de publicar.
Documenta claramente el Pull Request.

❌ Evita esto

Mezclar cambios no relacionados.
Publicar información sensible.
Forzar procesos sin comprender las consecuencias.

Resumen final

Actualiza el repositorio.
Crea una rama de trabajo.
Desarrolla y prueba.
Realiza commits claros.
Publica la rama.
Abre el Pull Request.
Atiende revisiones.
Integra y sincroniza.

Tabla rápida de comandos

Necesidad	Comando
Confirmar raíz del repositorio	`git rev-parse --show-toplevel`
Ver remotos	`git remote -v`
Ver rama actual	`git branch --show-current`
Ver estado	`git status --short --branch`
Actualizar referencias remotas	`git fetch origin`
Listar ramas locales y seguimiento	`git branch -vv`
Cambiar a la rama base	`git switch main`
Actualizar base con fast-forward	`git pull --ff-only origin main`
Crear rama desde base remota	`git switch -c feature/ISSUE-123 origin/main`
Revisar cambios no preparados	`git diff`
Revisar cambios preparados	`git diff --staged`
Comprobar espacios en blanco	`git diff --check`
Preparar archivos seleccionados	`git add <archivos>`
Crear commit	`git commit -m "mensaje"`
Publicar rama y configurar seguimiento	`git push -u origin feature/ISSUE-123`
Incorporar cambios de la base por merge	`git merge origin/main`
Borrar rama local ya integrada	`git branch -d feature/ISSUE-123`

Referencias oficiales