Flujo de trabajo para publicar cambios

1. Crear una nueva rama

Antes de hacer cambios, crea una rama nueva desde main:

git checkout main
git pull origin main
git checkout -b nombre-de-tu-rama

Ejemplo de nombres descriptivos:

  • actualizar-cv
  • agregar-publicacion-2024
  • corregir-enlaces

2. Agregar y registrar cambios

Después de editar tus archivos:

# Ver qué archivos cambiaron
git status

# Agregar archivos específicos
git add archivo1.html archivo2.md

# O agregar todos los cambios
git add .

# Registrar los cambios con un mensaje descriptivo
git commit -m "Descripción clara de los cambios"

Ejemplos de buenos mensajes:

  • git commit -m "Actualizar CV con nueva publicación"
  • git commit -m "Corregir enlace roto en página de contacto"

3. Subir cambios al repositorio remoto

Para subir tu rama por primera vez:

git push --set-upstream origin nombre-de-tu-rama

O la versión corta:

git push -u origin nombre-de-tu-rama

Para subidas posteriores en la misma rama:

git push

4. Crear un Pull Request (PR) en GitHub

  1. Ve a https://github.com/maclenn77/adela-academy
  2. Verás un banner amarillo que dice "Compare & pull request" - haz clic ahí
  3. Escribe un título descriptivo para tu PR
  4. Agrega una descripción de los cambios (opcional pero recomendado)
  5. Haz clic en "Create pull request"

5. Fusionar cambios a Main

Una vez que el PR esté listo:

  1. En la página del PR, revisa los cambios una última vez
  2. Haz clic en "Merge pull request"
  3. Confirma con "Confirm merge"
  4. Opcionalmente, elimina la rama con "Delete branch"

¡Los cambios se publicarán automáticamente! GitHub Actions se encargará de actualizar tu sitio web.

6. Actualizar tu repositorio local

Después de fusionar, actualiza tu rama main local:

git checkout main
git pull origin main

7. Continuar trabajando

Opción A: Crear una nueva rama para nuevos cambios

git checkout -b otra-rama-nueva

Opción B: Reutilizar la rama anterior (con rebase)

git checkout nombre-de-tu-rama
git rebase main

El rebase actualiza tu rama con los últimos cambios de main.

Comandos Git útiles

git status

Muestra el estado actual: archivos modificados, agregados, etc.

git status

git log

Muestra el historial de commits

# Historial completo
git log

# Historial compacto (una línea por commit)
git log --oneline

# Ver últimos 5 commits
git log -5

# Salir del log: presiona 'q'

git checkout

Cambia entre ramas o restaura archivos

# Cambiar a una rama
git checkout nombre-rama

# Crear y cambiar a una nueva rama
git checkout -b nueva-rama

# Descartar cambios en un archivo
git checkout -- archivo.html

git branch

Administra ramas

# Ver todas las ramas
git branch

# Ver ramas incluyendo remotas
git branch -a

# Crear una rama (sin cambiar a ella)
git branch nombre-nueva-rama

# Eliminar una rama local
git branch -d nombre-rama

# Forzar eliminación de rama
git branch -D nombre-rama

git push

Sube cambios al repositorio remoto

# Primera vez (establece upstream)
git push -u origin nombre-rama

# Subidas posteriores
git push

# Eliminar rama remota
git push origin --delete nombre-rama

git pull

Descarga y fusiona cambios del remoto

# Actualizar rama actual
git pull

# Desde rama específica
git pull origin main

git rebase

Reorganiza commits aplicándolos sobre otra rama

# Rebase sobre main
git rebase main

# Si hay conflictos, después de resolverlos:
git add archivo-resuelto
git rebase --continue

# Cancelar rebase
git rebase --abort

⚠️ Nota: Después de hacer rebase, si ya habías subido la rama antes:

git push --force-with-lease

git revert

Deshace un commit creando uno nuevo (no borra historial)

# Revertir el último commit
git revert HEAD

# Revertir commit específico
git revert abc123

# Revertir sin crear commit automático
git revert --no-commit abc123

Consejos prácticos

  1. Siempre haz git pull antes de crear una rama nueva - asegura que trabajas con la versión más reciente

  2. Usa nombres descriptivos para ramas y commits - facilita entender qué cambios contiene cada uno

  3. Haz commits pequeños y frecuentes - es más fácil encontrar y corregir problemas

  4. Revisa con git status constantemente - te mantiene orientada sobre qué has cambiado

  5. No tengas miedo de experimentar - puedes crear ramas de prueba y eliminarlas si no funcionan

Ejemplo de flujo completo

# 1. Preparar
git checkout main
git pull origin main
git checkout -b actualizar-bio

# 2. Hacer cambios en tus archivos
# (editar bio.html en tu editor)

# 3. Guardar cambios
git status
git add bio.html
git commit -m "Actualizar biografía con proyecto reciente"

# 4. Subir
git push -u origin actualizar-bio

# 5. Crear PR en GitHub (en el navegador)

# 6. Después de fusionar en GitHub
git checkout main
git pull origin main
git branch -d actualizar-bio

Si tienes dudas o algo no funciona como esperas, no dudes en preguntar.