Parte I: Empieza aquí

Palabras clave

Quarto, publicación reproducible, agentes de programación, Markdown, Python, EPUB, análisis de datos, k-means

La Parte I tiene dos rutas, y solo necesitas una de ellas. Las dos empiezan con los mismos dos capítulos de lectura: uno para el paso Publica del ciclo y otro para Pide y Revisa.

El 1  Publicar algo que se reconstruye solo, Publicar algo que se reconstruye solo. Por qué los informes hechos a mano se desactualizan, y cómo Quarto reconstruye cada salida desde una sola fuente para que eso no pase. Seguirás un archivo a través de los tres pasos de un renderizado, aprenderás exactamente qué promete “reproducible” y verás cuándo Quarto no es la herramienta adecuada.

El 2  Trabajar con un agente de programación, Trabajar con un agente de programación. Qué es un agente, cuánto cuesta, hasta dónde llega su alcance y cómo pedirle un trabajo que puedas verificar: el vocabulario, la especificación y la verificación con las que cada capítulo posterior enseña un formato de salida. Aprenderás a leer los recuadros prácticos del libro, y cómo declarar el uso de un agente cuando el trabajo es de investigación.

Luego toma la ruta que te convenga.

La vía rápida, el 3  La vía rápida, es para quienes ya usan una terminal y Git: analistas, especialistas en ciencia de datos, en ingeniería y quienes fundan una startup. En menos de una hora agrega Quarto a un repositorio existente y lo lleva a un informe en HTML, Word y PDF, calculado a partir de los propios resultados del repositorio, con guardas y revisado como un pull request.

Desde cero, el 4  Preparar tu computadora y el 5  Un primer informe, a mano, es para todos los demás. Seis pasos, cada uno con una comprobación que puedes ver, llevan una terminal vacía hasta un agente, Quarto y Python funcionando, y terminan cuando una página web y un PDF que construyó tu propia computadora dicen 42. Luego, un informe de una página con un número equivocado, que se renderiza sin errores: lo copias, lo renderizas y encuentras el número equivocado al compararlo con sus datos, lo registras con Git, cambias los datos y deshaces el cambio, y lees tres errores cometidos a propósito. Solo entonces el agente hace su primera edición, y tú revisas su diff antes de hacer commit. Calcula más o menos una hora para la preparación y unos 45 minutos para el primer informe, en un escritorio y con buena conexión.

Dónde estamos: Parte I: Empieza aquí, resaltada entre las cinco partes del libro. Sus capítulos en orden: 1, Publicar algo que se reconstruye solo, lees: por qué una sola fuente es mejor que las copias; 2, Trabajar con un agente de programación, lees: cómo pedir trabajo y revisarlo; 3, La vía rápida, construyes: un informe en tres formatos, revisado como pull request, termina en el punto de control 14; 4, Preparar tu computadora, construyes: una computadora que renderiza la prueba; 5, Un primer informe, a mano, construyes: un informe que revisas, corriges y guardas en Git.

Dónde estamos: Parte I.