Parte I: Empieza aquí
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.