Abrir la bitácora de nuevo
Por qué vuelvo a escribir en un sitio propio, y qué pienso anotar acá.
Este dominio llevaba meses sirviendo documentación de un producto. Hoy lo vacié y quedó esto: un cuaderno.
La razón es simple. Escribo cosas todos los días —mensajes de commit, descripciones de pull request, respuestas largas en un hilo de Slack— y todas se pierden. El razonamiento que me costó tres días reconstruir queda enterrado en un canal que nadie va a volver a abrir. Un blog no es más que ese mismo texto, pero guardado donde puedo encontrarlo.
Qué va a haber acá
Entradas cortas, casi siempre sobre una sola cosa:
- Decisiones técnicas y, sobre todo, las que descarté. La alternativa que no elegí suele explicar mejor el sistema que la que sí.
- Errores en producción, con lo que los causó. No la versión limpia que cuento en una retro, sino la secuencia real.
- Herramientas que cambiaron cómo trabajo, después de usarlas lo suficiente como para conocerles los bordes.
Qué no
No voy a escribir tutoriales de “cómo empezar con X”. Hay miles y casi todos son mejores que el que yo haría. Tampoco voy a publicar por calendario: si en dos meses no aprendí nada que valga la pena anotar, el registro se queda quieto y está bien.
Un cuaderno de taller no se llena para que alguien lo lea. Se llena para poder volver.
En español
Casi todo lo que leo sobre esto está en inglés, y traduzco sin darme cuenta. Pero cuando pienso un problema difícil, lo pienso en español. Escribirlo en el idioma en que lo pensé me obliga a entenderlo de verdad, no a repetir la frase hecha que ya venía armada.
Si algo de acá te sirve, mejor. Pero el destinatario principal soy yo en seis meses, cuando vuelva a toparme con el mismo problema y no me acuerde de nada.