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?