Esta es una herramienta interactiva para enseñar el flujo de trabajo de control de versiones de forma dinámica y que puedan ver en tiempo real cómo va cambiando el estado de cada archivo, en vez de imaginárselo. Este simulador cubre el flujo básico y lineal (sin ramas ni forks); esos temas quedan para un simulador aparte más adelante.
A continuación te explico paso a paso los elementos que tiene el simulador, cómo puedes usarlos y cuál es el objetivo de cada parte:
Historia guiada y práctica libre
El simulador tiene dos pestañas:
- Historia guiada: te lleva paso a paso por doce situaciones, en orden, con el comando de Git, la explicación de qué hace y el control de RStudio ya listo para que lo uses.
- Práctica libre: no sigue un guión. Editas archivos, los preparas, haces commits, simulas cambios en GitHub y pruebas tú mismo qué pasa con push y pull, sin perder nada ni tener un repositorio real detrás.
Qué significa cada estado
Cada archivo pasa por cuatro estados, los mismos que ves en la leyenda de colores arriba del tablero:
- Sin rastrear: es un archivo nuevo que Git todavía no vigila.
- Modificado: ya es conocido por Git, pero tiene cambios desde el último commit.
- Preparado: marcaste ese cambio con Staged para que entre en el próximo commit.
- Guardado: ya quedó guardado en el historial local con un commit.
Cómo leer el tablero
Esta parte es la misma en las dos pestañas, lo que cambia es quién decide las acciones, tú en práctica libre o la historia guiada paso a paso.
- En tu computadora: tiene tres columnas, los tres lugares por los que pasa un archivo antes de quedar guardado, Tu carpeta, Staging y Repositorio.
- En la nube: es GitHub, el repositorio remoto.
- Historial de commits: dos líneas de tiempo paralelas que avanzan hacia la derecha, una que refleja lo que sucede de forma local en tu computadora y otra en GitHub.
12 pasos para aprender
La historia guiada tiene doce pasos. El panel de la derecha simula la pestaña de Git de RStudio, con un botón o una casilla que solo se activa cuando corresponde usarlo, para que relaciones cada acción con su lugar real en RStudio. A lo largo de los doce pasos aparecen las situaciones que más se repiten trabajando con control de versiones:
- Hacer tu primer commit y los siguientes.
- Editar un archivo que ya tenía un commit anterior y volver a prepararlo.
- Que alguien más suba un cambio a GitHub sin que tú lo sepas.
- Resolver un push rechazado haciendo pull primero.
Más recursos para seguir aprendiendo de forma visual
- Learn Git Branching (GitHub)
- Visualizing Git
- git-sim
- Git resources for visual learners, GitLab
- Software Carpentry, El Control de Versiones con Git
Este simulador está disponible bajo licencia Creative Commons Atribución 4.0 (CC BY 4.0), la misma que usa Software Carpentry para su material. Puedes usarlo libremente en tus propias clases o talleres, adaptarlo o compartirlo, dando crédito y enlazando a este sitio.