Sobre este manual

Es la documentación técnica del área de IT de Transer: cómo se trabaja, con qué herramientas y con qué reglas. No es de un proyecto, aunque los ejemplos salgan de los que hay en marcha.

Por qué se reescribió

El manual de Git que había —416 líneas, bien escritas— daba por sabido lo que venía a enseñar. Abre con «todo se ejecuta en PowerShell» y la tabla de ramas, así que para entender su primer párrafo ya había que saber qué es un repositorio, una rama, una solicitud de cambio y una fusión.

Era un cómo-se-hace para quien va a teclear. Faltaba el qué-es para quien va a entender.

Hacerlo «más fácil» no lo arreglaba, porque no sobraba dificultad: faltaba el documento anterior. Por eso ahora son dos caminos, y el primero no trae un solo comando.

El área no es solo quien escribe código. Hay quien decide, quien revisa, quien pregunta por qué un cambio tardó y quien hereda el sistema dentro de dos años. Un manual que solo sirve a quien teclea deja fuera a casi todos ellos.

Cómo está organizado

	Para quién
Git, de cero	Siete partes. La primera, para cualquiera; las siguientes, para quien lo va a usar
Preparar el equipo	Quien monta una máquina nueva: herramientas, llaves y los dos entornos
Vórtice	Quien entra al proyecto: el método, el flujo y las compuertas

Una regla que lo mantiene honesto

Este sitio explica el proceso. Las reglas vivas están en los repositorios.

Las skills de derivación, los registros de decisión y las especificaciones son la norma, y cada una vive donde se aplica. Aquí se explica cuándo y por qué se usa cada cosa, y se remite al sitio donde está el cómo.

No es ceremonia: es lo que impide que este manual se vuelva una cuarta copia que se desvía. Un documento que repite una regla y se queda atrás es peor que no tenerlo, porque alguien lo cita.

Qué NO está aquí todavía

Los manuales que ya estaban escritos se han ido trayendo, pero el área hace más cosas de las que hay documentadas. Lo que falte se irá sumando.

Se anuncia cuando llega, no antes. Un índice que promete páginas que no existen enseña a no confiar en el índice.