Saltar al contenido

Lección 1.3 Comprender el recorrido

Git como punto de partida

Relacionar versiones, ramas y revisiones con la posibilidad de entender y recuperar un cambio.

Un paquete sin remitente ni etiqueta puede contener el producto correcto. Aun así, si aparece una diferencia, nadie sabe de dónde salió. Una carpeta llamada «final_ahora_si» ofrece la misma dificultad: parece una versión, pero no cuenta qué cambió.

Git registra cambios en archivos y permite comparar estados. Un repositorio compartido facilita revisarlos con otras personas. Git es la herramienta de versiones; GitHub o GitLab pueden alojar ese repositorio y añadir revisión y automatización. Son piezas relacionadas, no nombres para lo mismo.

Registra cambios que puedan explicarse

Un commit es un estado registrado, con un identificador y un mensaje. Ese identificador nos ayuda a relacionar código, ejecución y entrega. No demuestra por sí solo que el cambio esté probado ni que el directorio de trabajo no tenga modificaciones adicionales.

Un registro inicial podría contener los siguientes pasos. Léelos como una secuencia ilustrativa: primero se define el repositorio, después se seleccionan los archivos y finalmente se registra un cambio coherente.

git init -b main
git add pedido.py app.py tests
git commit -m "Define la regla de envío y sus comprobaciones"
git status
git log --oneline -3

La selección de archivos también forma parte de la decisión. Un .gitignore puede excluir entornos virtuales y resultados generados; no elimina del historial lo que ya fue registrado. El equipo debe revisar qué conserva y qué no debería compartirse.

Una rama abre una conversación sobre un cambio

git switch -c ajuste-envio
git diff
git status

La rama permite preparar una modificación separada de la referencia principal. Cuando exista un repositorio compartido, una solicitud de revisión —pull request o merge request— ayuda a contrastar el cambio antes de integrarlo. El nombre de la función puede variar; la conversación debería responder qué necesidad atiende, qué se comprobó y qué puede afectar.

No tienes que poner todo el proyecto en un solo commit cada vez. Agrupar cambios coherentes hace más fácil explicar y recuperar una decisión. Tampoco conviene separar tanto que ninguna parte tenga sentido por sí sola.

Lee una diferencia antes de aceptarla

Compara mentalmente subtotal >= 10000 y subtotal > 10000. Explica, en una frase, a qué cliente afecta la diferencia. No necesitas ejecutar nada: basta con situar un pedido exactamente en el límite.

La consecuencia del cambio

El cliente con subtotal exactamente igual a S/ 100.00 pasaría a pagar envío. El cambio ocupa un carácter, pero altera una regla del negocio. El tamaño de la diferencia no mide su impacto.