Part I: Start Here

Keywords

Quarto, reproducible publishing, coding agents, Markdown, Python, EPUB, data analysis, k-means clustering

Part I has two routes, and you need only one of them. Both start with the same two chapters of reading: one for the Publish step of the loop, one for Prompt and Check.

1  Publishing That Rebuilds Itself, Publishing That Rebuilds Itself. Why hand-made reports drift out of date, and how Quarto rebuilds every output from one source so that they cannot. You will follow one file through the three steps of a render, learn exactly what “reproducible” promises, and see when Quarto is the wrong tool.

2  Working With a Coding Agent, Working With a Coding Agent. What an agent is, what it costs, how far its reach goes, and how to ask it for work you can verify: the vocabulary, specification and verification that every later chapter teaches a format through. You will learn to read the book’s hands-on boxes, and how to account for an agent’s use when the work is research.

Then take the route that fits you.

The fast path, 3  The Fast Path, is for readers who already use a terminal and Git: analysts, data scientists, engineers and founders. In under an hour it adds Quarto to an existing repository and takes it to a report in HTML, Word and PDF, computed from the repository’s own results, guarded and reviewed as a pull request.

From zero, 4  Setting Up Your Machine and 5  A First Report, by Hand, is for everyone else. Six steps, each with a check you can see, take an empty terminal to a working agent, Quarto and Python, ending when a web page and a PDF that your own computer built both say 42. Then a one-page report with a wrong number in it, which renders without an error: you copy it, render it and find the wrong number by checking it against its data, record it with Git, change the data and undo the change, and read three errors made on purpose. Only then does the agent make its first edit, and you check its diff before you commit it. Allow about an hour for the setup and about 45 minutes for the first report, at a desk with a good connection.

Where we are: Part I: Start Here, highlighted among the book's three parts. Its chapters in order: 1, Publishing That Rebuilds Itself, read: why one source beats copies; 2, Working With a Coding Agent, read: how to ask for work and check it; 3, The Fast Path, build: a report in three formats, reviewed as a pull request, ends at checkpoint 14; 4, Setting Up Your Machine, build: a computer that renders the test run; 5, A First Report, by Hand, build: a report you checked, fixed and committed.

Where we are: Part I.