Versiones: qué guardar y cuándo

Resumen

Un proyecto sin historial es un cuaderno sin fechas: sabes dónde estás, pero no cómo llegaste. Esta sesión convierte tu carpeta en un repositorio y cada decisión en una versión con su razón. Es la base para dejar trabajar a un agente: lo que se guarda, se puede recuperar.

1. 1

   Repositorio, estado y versión

   Un repositorio es la carpeta de tu proyecto con memoria: Git registra cada versión que decides guardar. El estado es la diferencia entre cómo están tus archivos ahora y la última versión guardada. Una versión, o commit, es una fotografía del proyecto completo con autor, fecha y mensaje.

2. 2

   Iniciar, preparar y guardar

   git init crea el repositorio, una sola vez, en la carpeta del proyecto. git add elige qué cambios entran en la próxima versión y git commit la guarda. El paso intermedio importa: decides qué va junto, como decides qué cabe en una misma entrada del cuaderno.

3. 3

   Mensajes con razón

   La primera línea del mensaje dice qué cambió, en pocas palabras. El cuerpo, separado por una línea en blanco, dice por qué. El cambio siempre se puede leer en los archivos; la razón, solo en el mensaje.

Abres la bitácora de tu proyecto: cada decisión metodológica queda fechada y con su razón.