¿Qué conviene guardar de un proyecto, y cuándo?

Se guarda una versión cada vez que el proyecto queda en un estado que tiene sentido por sí mismo, con un mensaje que dice qué cambió y por qué. Una decisión, una versión.

Versiones: qué guardar y cuándo

El oficio que ya tienes

En campo no esperas al final del día para anotar: fechas cada observación, registras por qué cambiaste de pregunta o de informante y nunca arrancas una hoja. Un commit es esa entrada del cuaderno, con la fecha y el autor que Git agrega solo.

En Marienthal

El proyecto de clase empieza con un archivo: el cuestionario de uso del tiempo. La primera versión guarda las franjas de una hora, como el registro que se pidió en Marienthal en 1931. Si después decides cambiar a franjas de media hora, esa decisión va en su propia versión: «Franjas de media hora» en la primera línea y, en el cuerpo, la razón metodológica del cambio.

En tu proyecto

Convierte la carpeta de tu proyecto en repositorio y guarda una primera versión con lo que ya tienes, aunque sea solo tu pregunta en un archivo de texto. Luego anota una decisión que ya tomaste (a quién vas a preguntar, con qué límite) y guárdala en su propia versión, con su razón.

Conceptos

Repositorio: Una carpeta de proyecto cuyo historial registra Git. El historial vive en una subcarpeta oculta, .git, que no se edita a mano.
Estado: Lo que cambió en tus archivos desde la última versión guardada: archivos nuevos, modificados o borrados.
Área de preparación: La lista de cambios que entrarán en la próxima versión. git add los pone ahí; nada queda guardado hasta el commit.
Versión (commit): Una fotografía del proyecto completo con autor, fecha, mensaje y un identificador único.
Mensaje: El texto que acompaña cada versión: una primera línea breve con qué cambió y, si hace falta, un cuerpo con por qué.

Instrumental

git config --global user.name "Tu nombre": Decir una sola vez qué nombre firma tus versiones; user.email hace lo mismo con tu correo.
git init: Convertir la carpeta del proyecto en repositorio. Se hace una vez.
git add <archivo>: Poner los cambios de ese archivo en la próxima versión.
git commit -m "Qué cambió" -m "Por qué": Guardar la versión. El primer -m es la primera línea del mensaje; el segundo, el cuerpo.
git commit: Sin -m, abre un editor para escribir un mensaje largo, con título y cuerpo.

Para tu bitácora

¿Qué decisión de tu proyecto ya no podrías justificar hoy porque nunca anotaste por qué la tomaste?