Parte III: El oficio de los formatos de salida
Quarto, publicación reproducible, agentes de programación, Markdown, Python, EPUB, análisis de datos, k-means
La Parte II enseñó cada formato a través de una sola guía para una oficina de turismo. Esta parte es para los documentos que se les piden a los profesionales, y los toma de a un tipo por vez, a partir de un solo conjunto de resultados: la evaluación que empezó en el 3 La vía rápida, en la que Acme Signals, una startup ficticia, compara tres versiones de un modelo con datos públicos reales.
Cada capítulo enseña su formato de salida de la misma manera (la Vocabulario, especificación, verificación): el vocabulario de lo que el formato puede hacer, para que puedas pedirlo por su nombre; una especificación, un prompt probado y las reglas que van en AGENTS.md; y la verificación que muestra que el resultado es correcto, a partir del diff, el renderizado y las comprobaciones que se ejecutan sin ti. Pocas veces vas a escribir a mano un tema o una plantilla; muchas veces vas a necesitar saber que existen, cómo se llaman y cómo se ve uno bueno.
10 Un solo conjunto de resultados, Un solo conjunto de resultados. Por qué cada resultado se calcula una sola vez y todos los documentos lo leen, qué atrapa cada comprobación (las pruebas, las guardas y el renderizado), y una ficha del modelo (model card) escrita como una sola tarea más grande, con un plan primero y sus comprobaciones después.
11 Diapositivas que sostienen una decisión, Diapositivas que sostienen una decisión. Qué hace que una presentación técnica funcione, las funciones de Reveal.js que la sirven, un tema cuyo contraste comprueba una prueba, un PDF desde la vista de impresión, y la misma presentación en PowerPoint con una plantilla de la casa.
12 Un sitio y una sola marca, Un sitio y una sola marca. Un solo archivo de marca para el sitio, la presentación y los PDF, plantillas de Word y PowerPoint hechas a partir de él, un sitio web con página de inicio, una página About y búsqueda, y un script que revisa cada página.
13 White papers y referencias, White papers y referencias. Un documento que se sostiene solo fuera de la empresa: secciones numeradas, ecuaciones, tablas y figuras con referencias cruzadas, citas con un solo estilo en todos los formatos, referencias que un script confirma, y una plantilla de la casa para el PDF.
14 Informes que se generan solos, Informes que se generan solos. Un solo documento para muchos valores: un informe mensual para inversionistas, un informe por segmento de clientes y, para docentes, una hoja de retroalimentación por grupo de clase, con cada valor validado, sus palabras protegidas por guardas, y cada salida renderizada y revisada por un script.
Cada capítulo parte del punto de control en el que termina el anterior, así que puedes empezar por cualquiera; si llegaste por la ruta desde cero, haz primero la vía rápida, porque esta parte continúa su repositorio.