Seguro tienes uno. Un archivo que se llama precios_final.docx, y al lado precios_final_v2.docx, y al lado precios_final_v2_DEFINITIVO_ahora_si.docx. Lo guardaste así porque te daba miedo perder la versión anterior. Es un método sensato, y en una carpeta con cinco archivos que cambian cada semana se vuelve un laberinto. Este sendero te enseña la herramienta que resolvió ese problema hace veinte años y que usan casi todos los proyectos de software: git. El proyecto es el de siempre, la carpeta de la barbería que describiste en el sendero anterior.
El álbum de fotos de tu carpeta
Imagina que cada vez que tu carpeta queda en un estado que te gusta, le tomas una foto. La foto guarda todos los archivos tal como estaban, con la fecha y una nota tuya al pie: «subí el precio del corte», «agregué el horario». Las fotos se pegan en un álbum, una detrás de otra, y nunca se despegan. Cuando algo sale mal, abres el álbum y vuelves a la foto de ayer.
Eso es git. A la carpeta vigilada se le llama repositorio, y a cada foto, commit. Los archivos siguen siendo los tuyos, con sus nombres de siempre: PROYECTO.md, sin _v2. Las versiones viejas viven dentro del álbum, en una carpeta oculta llamada .git. Si conoces el historial de versiones de Word o de Excel cuando el archivo vive en OneDrive, la idea se parece, con dos diferencias: git vigila la carpeta entera, no un archivo, y la foto la decides tú.
¿Ya lo tienes?
Lo instalaste en el sendero Equipa tu terminal. Pregúntale la versión:
$ git --versiongit version 2.56.0
$ git --versiongit version 2.56.0.windows.4
Tu número puede ser otro; cualquier versión reciente sirve para todo el sendero.
Si la terminal no conoce git, vuelve a esa parada: es un comando y unos minutos de espera. Un detalle sobre el idioma, para que no te desconcierte.
El git que instalaste con Homebrew te habla en español si tu Mac está en español: «En la rama master», «el árbol de trabajo está limpio». Algunos renglones, los consejos que empiezan con «hint:» y los resúmenes como «1 file changed», siguen en inglés. Si ves todos los mensajes en inglés, tu Mac o tu Terminal están en inglés, o usas el git que trae el Mac; dice lo mismo.
En Windows, git te habla en inglés aunque tu computadora esté en español: Git for Windows no trae traducciones. No hace falta saber inglés para seguir este sendero, porque cada mensaje que importa lo vas a ver explicado aquí.
Mirar no rompe nada
El primer comando es el que más vas a usar: git status, «¿cómo está esto?». Pruébalo en una carpeta cualquiera:
$ git statusfatal: no es un repositorio git (ni ninguno de los directorios superiores): .git
$ git statusfatal: not a git repository (or any of the parent directories): .git
Una palabra que asusta y un mensaje inofensivo.
«fatal» suena a desastre, y en git significa solo «no pude hacer lo que pediste». Aquí dice que esta carpeta no es un repositorio, ni ella ni las de arriba: nadie le está tomando fotos. No se borró nada, no se cambió nada. git status y git log, el que muestra el álbum, son comandos de solo mirar: puedes escribirlos cien veces al día en cualquier carpeta y lo peor que te puede pasar es leer un mensaje que no entiendes. Cuando dudes de qué está pasando, empieza por git status. Es lo que hago yo.
Tu barbería ya tiene sus primeras fotos (o casi)
En el sendero anterior escribiste git init, git add . y git commit en la carpeta de la barbería, dos veces. Mira qué quedó:
$ git statusEn la rama masternada para hacer commit, el árbol de trabajo está limpio$ git log --oneline19e9720 (HEAD -> master) datos reales de la barberíacba69c9 proyecto descrito y archivos de manejo
Dos fotos en el álbum, y nada nuevo desde la última.
$ git statusOn branch masterNo commits yetChanges to be committed: (use "git rm --cached <file>..." to unstage) new file: CLAUDE.md new file: DATOS.md new file: ESTADO.md new file: PROYECTO.md new file: ROADMAP.md$ git logfatal: your current branch 'master' does not have any commits yet
«No commits yet»: el álbum está vacío, y los cinco archivos esperan.
Cada renglón es una foto: un código de siete caracteres, que es su nombre, y la nota que le pusiste. La de arriba es la más nueva. «el árbol de trabajo está limpio» quiere decir que la carpeta está igual que en la última foto. La rama es la fila de fotos; la tuya se llama master. Si en tu Mac git log dice que todavía no hay commits, te pasó lo mismo que en Windows: en la próxima parada sacas esa primera foto.
La rama es la fila de fotos; la tuya se llama master. En Windows las fotos del sendero anterior no llegaron a tomarse. Al hacer git commit, git respondió «Author identity unknown» y «Please tell me who you are»: no sabe quién eres y se niega a sacar una foto sin firma. Los cinco archivos quedaron preparados («Changes to be committed») y git log confirma que el álbum no tiene ninguna foto todavía. No perdiste nada. En la próxima parada firmas con tu nombre y sacas esa primera foto.
Una carpeta nueva: git init
Para vigilar cualquier otra carpeta, entras en ella y lo pides una sola vez:
$ git init# git sugiere otro nombre para la rama; por ahora no importaInicializado repositorio Git vacío en /Users/ana/precios/.git/$ git statusEn la rama masterNo hay commits todavíano hay nada para confirmar (crea/copia archivos y usa "git add" para hacerles seguimiento)
Antes del renglón «Inicializado…», git imprime trece consejos que empiezan con «hint:», sobre el nombre de la rama, que aquí se llama master.
$ git initInitialized empty Git repository in C:/Users/ana/precios/.git/$ git statusOn branch masterNo commits yetnothing to commit (create/copy files and use "git add" to track)
Un renglón y listo: la rama se llama master.
git init crea la carpeta oculta .git, que es el álbum, y nada más: tus archivos no se tocan. Desde ahí, git status ya contesta, aunque el álbum esté vacío. Si lo repites en una carpeta que ya vigilas, git avisa que la reinicializó y deja todo como estaba. Lo único que no conviene es hacerlo en tu carpeta personal entera o en Documentos: git vigilaría miles de archivos que no tienen nada que ver. Un repositorio por proyecto, en su propia carpeta, como la barbería.
Se acabaron los _final_v2. En la próxima parada firmas tus fotos y aprendes a sacarlas: git add y git commit.
