Changelog
Source:NEWS.md
misc.tutorials (development version)
antigravityarrives fromvscode.tutorials, shortened to a sign-in-and-try-it tutorial at ordering 1. Every other tutorial’s ordering moves up by one.The R4DS family now has a deliberate pacing gradient.
r4ds-1andr4ds-2open with four slow Introduction exercises, the lowercase-name warning and a spelled-outdownload.file().r4ds-3andr4ds-4keep the standard three-exercise Introduction. Fromr4ds-5on the Introduction is two exercises: one creates the repo,analysis.qmd,.gitignoreand the libraries chunk, the other thedata/directory.Three tutorials now teach the Codespace itself, a recorded departure from the base guide’s environment-neutral rule. In
r4ds-5the student downloads the data file to their own computer and drags or pastes it into the Codespace. Inr4ds-6three exercises tour/workspaceswithpwd,ls ..,ls -aandcd. Inr4ds-7the student runsconnect-repoa second time to maker4ds-7-new, switches folders withFile -> Open Folder..., and then deletes the extra repo both locally and on GitHub. Inr4ds-8two exercises review the picture withls /workspacesandgit remote -v.census-1is split in two.census-1keeps the Texas income map and adds two exercises on the margin of error: a table of the counties where it is largest relative to the estimate, and a second map of that share. The newcensus-2takes the state education chart and the California age scatterplot, with the scatterplot’s log scale now a step of its own. They run 17 and 18 exercises instead of 28.The R4DS family is renumbered
r4ds-1throughr4ds-10, each spin-out in the slot after its parent:musicis nowr4ds-2, the oldr4ds-2(births) isr4ds-3,nba-recruitsisr4ds-4, the oldr4ds-3(school districts) isr4ds-5,time-useisr4ds-6, the oldr4ds-4(crypto) isr4ds-7,prediction-marketsisr4ds-8, the oldr4ds-5(wildfires) isr4ds-9, andimdb-rankingsisr4ds-10. Titles follow (“R4DS 2” and so on), as do the repo names and download URLs inside each tutorial. The introductory scaffolding moved with the slots:r4ds-2now spells out thedata/commands and thedownload.file()call, andr4ds-3(births) uses the goal-stated form like every later tutorial. Older entries below use the names current when they were written.The census tutorials’ folders are
census-1andcensus-2(formerlycensusanddemographics), so their order is visible at a glance; their titles stay Mapping Census Data and Census Demographics. The list order isr4ds-1tor4ds-10, thencensus-1andcensus-2, then the topic tutorials.Every Summary now ends the same way. Its first exercise is a final render, commit and push, answered with the URL of
analysis.qmd(orindex.qmd) on GitHub; that link is the record of the whole file. The whole-fileshow_file("analysis.qmd")paste is gone: with nochunkargument,show_file()prints only the last chunk, so the whole-file answer shown after Continue never matched what students saw. The separate repo-URL exercise is gone too, since the file URL contains it.Every commit question asks for
git log --oneline -3. The three census questions that accepted “a short note describing how you committed and pushed” now do too.No tutorial explains how to take a screenshot any more. That sentence belongs to the first three
vscode.tutorials; every screenshot question here just asks for the screenshot.Editorial pass over every tutorial: prose has almost no semicolons and filler sentences are gone. No exercise asked for two pastes, so none were split. The repo line no longer says “You may need to restart this tutorial after you do so,” which was a learnr artifact.
Every code block now says what it is: commands carry their language (
r,bash,yaml), text to type that is in no language (commit messages,.gitignorelines, download URLs) isdefault, and transcripts and the answers shown after Continue are{.output}, which renders lighter and without a copy button. The 376 bare fences are gone, solearnr2::check_tutorial()runs clean.Every screenshot question is image-only (
allow_text = FALSE), and the first one in each tutorial says how to take a screenshot and paste it. Needs the learnr2 that shipsallow_text.The R for Data Science material is now ten tutorials instead of five. Each two-topic tutorial was split in two, keeping its first topic and spinning the second out under a topic name:
r4ds-1(Billboard) andmusic,r4ds-2(US births) andnba-recruits,r4ds-3(school districts) andtime-use,r4ds-5(wildfires) andimdb-rankings. Withprediction-markets(split fromr4ds-4in August) the family runs 18–25 exercises per tutorial, and the VS Code list shows each spin-out directly after its parent (ordering1–10), followed bycensus-1,baseball,ducks,sharks, andmovies.spidermanis retired; its Spider-Man comparison is now the closing topic ofmovies.ducksandsharksare rebuilt on the multi-page website form thatbaseballintroduced, and every tutorial now follows the three-exercise caching arc exactly once.census-1andbaseballwere shortened as well; every tutorial now runs 18–28 exercises.Package-wide clean-up: every question carries a complete plain-text copy of its prompt; faked listings include the
AGENTS.mdthat every fresh repo contains; fakedgit logandquarto publishtranscripts match their real shape; knowledge drops are trimmed to two sentences about the data or the output; retired AI-tool recommendations are replaced by “Use AI however you like.”; stalequarto previewinstructions and maintainer comments are gone.r4ds-1shipsbillboard.csv(a copy oftidyr::billboard) instead of loading the data from a package;r4ds-3andtime-usehave students gitignore their.duckdbfiles;sharksno longer shipsattacks.csvorattacks.rds.Rebuilt every tutorial on learnr2, which renders each one to a static Quarto page whose code runs in the browser via WebR. learnr2 is the package’s only tutorial dependency (it also supplies
show_file()), and the tests and CI render tutorials withlearnr2::check_tutorial()andlearnr2::render_tutorials(). Plot exercises now ask for a screenshot of the rendered plot instead of the code that drew it.