Saltar al contenido
← Sesión 07

Ficha · Sesión 07 · Módulo II, La bitácora

«De la pregunta a la herramienta»

¿Cómo se revisa un trabajo que hizo alguien más antes de darlo por bueno?

Completo y con sospecha: se lee cada renglón que cambió, contra lo que se pidió, antes de guardarlo. Lo que no entiendes no se guarda.

Leer lo que cambió el agente

El oficio que ya tienes

Ya revisas trabajo de campo ajeno: la codificación de otra persona del equipo se lee con el libro de códigos al lado, entrada por entrada, y lo que no cuadra se anota y se pregunta. El diff es esa revisión, aplicada a lo que hizo el agente.

En Marienthal

Le pides al agente que agregue al cuestionario una pregunta sobre las horas de sueño. git status muestra dos archivos modificados, no uno. git diff revela que, además, cambió las opciones de respuesta de una pregunta anterior. Ese cambio no se pidió: se discute o se descarta antes de guardar, igual que una codificación que no sigue el libro de códigos.

En tu proyecto

Pide al agente un cambio pequeño en tu proyecto y, antes de guardarlo, revísalo con git status y git diff. Anota qué pediste, qué hizo y qué no esperabas. Guarda solo lo que entiendes, y después recorre tu historial con git log.

Conceptos

Diff
La comparación renglón por renglón entre dos estados de un archivo. El signo - marca lo que se quitó; el +, lo que se puso.
Identificador
El código de letras y números que distingue cada versión. Para nombrarla suelen bastar sus primeros siete caracteres.
Historial
La lista de versiones guardadas, cada una con autor, fecha y mensaje. Se lee con git log.
Plegar
Ocultar en el editor una sección de un archivo y dejar solo su primera línea a la vista. El contenido no cambia; solo deja de estorbar.

Instrumental

git status
Ver qué archivos cambiaron, cuáles son nuevos y cuáles ya están preparados.
git diff
Leer renglón por renglón los cambios que todavía no preparas.
git diff --staged
Leer lo que ya preparaste con git add, antes de guardarlo.
git log --oneline
Ver el historial en una línea por versión: identificador y primera línea del mensaje.
git show <id>
Ver una versión completa: autor, fecha, mensaje y sus cambios.

Para tu bitácora

¿Con qué criterio decides que un cambio del agente está bien, y dónde está escrito ese criterio?

viridiana.dev · Viridiana