Oficio, calidad y equipos · Principiante

Trabajar con versiones: ramas, fusiones e historial

En una línea: Las ramas cortas y las fusiones frecuentes evitan la mayor parte del dolor de versiones, y un historial legible vale el esfuerzo el día que investigas un incidente.

Un flujo simple

Una rama principal estable, ramas cortas por cada cambio, una fusión tras la revisión y las pruebas. Una rama que vive dos semanas creará conflictos y una fusión aterradora: casi siempre es señal de que la tarea es demasiado grande.

Mensajes de cambio

Una primera línea corta que diga qué cambió, luego por qué. El 'por qué' es lo que no se puede recuperar del código, y lo que buscarás dentro de un año.

Enlaza a la tarea o el debate. Un cambio sin contexto es un enigma futuro.

Higiene

No guardes archivos construidos, secretos ni archivos grandes en el repositorio. Etiqueta las versiones con marcadores. Y no reescribas el historial ya publicado: rompe el trabajo de los demás.

En profundidad

Decide una política de fusión —preservar el historial completo o aplastar a un único cambio— y aplícala. La coherencia importa más que la elección en sí, porque un historial mezclado es difícil de navegar justo cuando necesitas encontrar cuándo se rompió algo.