6 posts
La programación literaria promete una única fuente de verdad, pero los pasos manuales de weave y tangle rompen la pipeline de CI/CD. Así es como automatizar la extracción y generación de documentación para que tus archivos Markdown sean canónicos.
Si tu pipeline de construcción no puede ejecutarse sin que abras una terminal y escribas , no tienes un programa literario. Tienes un diario con un compiler…
Pasé 30 días escribiendo explicaciones de diseño antes de pedirle código a un LLM. Los resultados cambiaron cómo pienso sobre el rubber-ducking.
La mayoría de los desarrolladores usan los LLMs al revés. Describimos lo que queremos en cinco palabras, recibimos 200 líneas de código y pasamos la siguiente…
La programación literaria mantiene la documentación, los tests y la implementación sincronizados al convertir un archivo Markdown en la única fuente de verdad. Así es como implementarlo en treinta líneas de Python.
Tus docs, tests y código son tres archivos contando la misma historia mal. Actualizas la firma de la función en el source. Olvidas el ejemplo del README. Una…
Las conversaciones con LLM contienen intención, alternativas rechazadas y código funcional. Eso es exactamente lo que la documentación debería ser. Aquí está cómo convertir chat efímero en documentación durable y buscable sin perder la narrativa.
Pasaste cuarenta y cinco minutos con Claude diseñando un circuito de reintento. Explicaste los modos de falla, rechazaste el backoff exponencial porque oculta…
Cada compilador ve tu código como un árbol, pero tu editor te deja editar texto en bruto. Así es como se ve realmente la edición estructurada, por qué no se ha impuesto y cómo aprovechar sus beneficios sin cambiar de herramientas.
Cada lenguaje de programación tiene una gramática formal. Tu compiler la lee, construye un árbol de análisis y rechaza todo lo que no encaje. Tu editor ignora…
La programación literaria prometía que el código debía escribirse primero para humanos y segundo para máquinas. Cuatro décadas después, casi nadie escribe de esa manera. He aquí por qué la idea más elegante en la documentación de software no logró cambiar la forma en que trabajamos.
En 1984, Donald Knuth publicó un artículo que proponía una inversión radical. Los programas no deberían escribirse para compilers y anotarse para humanos.…