Git con contexto: tu primer flujo de ramas y commits en GitKraken
Etiquetas sugeridas: git, gitkraken, tutorial, beginners
Soy ambassador de GitKraken. En esta guía comparto un ejercicio práctico para aprender Git con apoyo visual y entender qué hace cada operación.
Terminas un cambio, haces commit y descubres que también agregaste un archivo que no tenía relación. El problema empezó antes del commit: faltó revisar qué iba a entrar en él.
Vamos a construir un flujo pequeño: crear una rama, modificar un archivo, revisar el diff y registrar un cambio con intención. Usaremos GitKraken Desktop para observar el historial y una terminal para preparar un laboratorio reproducible.
Antes de empezar
Necesitas Git, GitKraken Desktop y un editor de texto. Los comandos funcionan en Bash, Zsh o Git Bash en Windows. Ejecuta el ejercicio en una carpeta nueva, fuera de tus proyectos. No necesitas un remoto.
1. Prepara el repositorio
mkdir taller-git-ramas
cd taller-git-ramas
git init -b main
git config user.name "Demo Git"
git config user.email "demo@example.com"
printf '# Portal demo\n' > README.md
git add README.md
git commit -m "docs: crear descripción inicial"
La identidad queda configurada únicamente en este repositorio. El primer commit será el punto de partida.
Abre la carpeta desde la opción de abrir un repositorio existente de GitKraken Desktop. Localiza el commit y la etiqueta main en el gráfico.
2. Crea una rama para una sola tarea
La tarea será documentar cómo iniciar el portal.
En GitKraken, haz clic derecho sobre el commit de main, selecciona Create branch here y escribe docs/inicio-local. Después haz doble clic en la rama para activarla. Este procedimiento está documentado en la guía oficial de ramas.
Antes de editar, comprueba que la rama activa sea docs/inicio-local.
Una rama nombra una línea de trabajo. Crear la rama todavía no produce cambios en los archivos ni un commit nuevo.
3. Haz un cambio fácil de revisar
En tu editor, reemplaza el contenido de README.md por:
# Portal demo
## Inicio local
Este repositorio es un laboratorio para practicar Git.
No requiere instalar dependencias ni levantar un servidor.
Guarda el archivo. Regresa a GitKraken y revisa el diff del cambio pendiente. Debe mostrar únicamente las líneas que acabas de agregar.
Pregúntate: ¿este cambio resuelve una sola tarea?, ¿el texto es correcto?, ¿hay algo accidental?
4. Prepara y crea el commit
Pasa README.md al área de staging y escribe:
docs: explicar el inicio del laboratorio
Crea el commit. El staging funciona como la selección de contenido que entrará en la siguiente versión: no tienes que incluir todo lo modificado.
Puedes verificar el resultado desde la terminal:
git status
git show --stat HEAD
git log --oneline --all --graph
Espera un directorio limpio y un commit adicional en docs/inicio-local. La rama main debe seguir en el commit inicial.
5. Integra el resultado
Como este laboratorio es local, integra directamente:
git switch main
git merge --ff-only docs/inicio-local
Observa el gráfico otra vez. main avanzó hasta el commit nuevo. No apareció un commit de merge porque pudo hacerse un avance directo, también llamado fast-forward.
En un equipo, normalmente publicarías la rama y abrirías un pull request antes de integrarla, según las reglas del repositorio.
El hábito que vale la pena conservar
Antes de cada commit, revisa rama, diff y staging. Es una pausa pequeña que permite explicar qué estás guardando y por qué.
GitKraken aporta una vista del historial; el criterio para decidir qué pertenece a un commit sigue siendo tuyo.
Reto: crea docs/objetivo, agrega una sección con el objetivo del laboratorio y repite el flujo. Antes de integrar, explica en voz alta qué cambió y qué rama lo contiene.
¿Qué te cuesta más al empezar con Git: las ramas, el staging o los mensajes de commit?
Top comments (0)