Appendix C — Changelog

Since we follow Conventional Commits when writing commit messages, we’re able to automatically create formal “releases” of the workshop based on the commit messages. Releases in the context of workshops are simply snapshots in time of the workshop content. The releases are published to Zenodo for easier discovery, archival, and citation purposes. We use Commitizen to be able to automatically create these releases, which uses SemVar as the version numbering scheme.

Because releases are created based on commit messages, we release quite often, sometimes several times in a day. This also means that any individual release will not have many changes within it. Below is a list of the releases we’ve made so far, along with what was changed within each release.

If you attended a workshop or used the workshop material as some point in time, you can always refer to this changelog page to find out what has been changed since you last used it.

C.1 8.1.1 (2026-04-07)

C.1.1 Fix

➕ add remotes to DESCRIPTION to trigger linking

C.1.2 Refactor

overview: ♻️ improvements to learning design from template

C.2 8.1.0 (2026-04-07)

C.2.1 Feat

sessions: ✨ add intro motivating paragraphs for first four sessions
sessions: ✨ add analogy of paper and functionals
sessions: ✨ describe design pattern of “do it once, do it for all”
sessions: ✨ add extra, optional exercises in functionals
pre-workshop: ♻️ switch to using nurses’ stress in pre-workshop
pre-workshop: ✨ create both a learning and cleaning Quarto docs
pre-workshop: ✨ install r3 from r-universe, not pak
appendix: ✨ add “For Teachers” appendix
pre-workshop: ✨ add learner code of conduct
overview: ✨ add learning design page
✨ logos for SDCA, DDEA, and AU
✨ add “includes” files from template

C.2.2 Fix

pre-workshop: 🐛 can’t download with R from Proton Drive
💄 load packages for correct downlit linking
✏️ revisions during editorial review
🐛 resolve build issues from changes
sessions: ✏️ switch learning objectives between functions and robustness
sessions: ✏️ correct sentence of key takeaway, it was incomplete
✏️ align on @returns with an s
appendix: 🔥 remove importing solution from appendix
sessions: ✏️ replace read, not import
sessions: ✏️ ‘instructor’ to ‘teacher’
pre-workshop: ✏️ state to install Rtools before trying pak
pre-workshop: ✏️ include URL to CRAN in install instructions
sessions: 🐛 close div that was incorrectly formatted
pre-workshop: 🐛 include code to execute ‘download data’ session
🐛 correct cross-refs to sections
sessions: 🐛 update to use rostools-theme for slides
sessions: 🔥 remove Discord text and link
🐛 correct or remove broken links
sessions: ✏️ correct links to code appendix includes

C.2.3 Refactor

pre-workshop: ✏️ clarify to commit after downloading the data
overview: 💄 aesthetically nicer layout of logos
sessions: 🚧 set sections as WIP and hidden until finalised
♻️ use “stable” badge to indicate the material is stable
sessions: ♻️ switch to using DIME for project work
sessions: ✏️ rename to be “robust and reusable” for session
appendix: 🔥 remove solutions appendix
sessions: ♻️ use nurses stress data in functionals
pre-workshop: 🔥 untar() will still run if exdir exists, don’t need fs anymore
sessions: ♻️ use nurses stress in robustness
sessions: ♻️ use nurses stress data in functions
sessions: ♻️ switch to using nurses stress in importing session
sessions: ♻️ use .by instead of group_by()
sessions: ✏️ clarify declarative vs imperative
pre-workshop: ♻️ moved GitHub setup into pre-workshop tasks
pre-workshop: ♻️ minor revisions to Git pre-workshop tasks
pre-workshop: 🔥 doc doesn’t need YAML header execute options
sessions: 🔥 learning design is now in pre-workshop tasks, not intro
overview: ♻️ use meta tag for feedback survey links in schedule
sessions: 🔥 keep “star us” on landing page only
♻️ formatting updates from template
🔧 update _quarto.yml with changes to file names
pre-workshop: 🚚 split pre-workshop tasks into several files
overview: ♻️ updates to landing page from template
overview: ♻️ move syllabus in overview/ and split into two files
overview: 🚚 moved schedule into overview/
sessions: ♻️ forgot to ungroup() after complete() (#194)

C.3 v2025.05.06 (2025-05-25)

C.3.1 Feat

✨ add teacher comment about project work
✨ code to tidy up the project work data a bit
sessions: ✨ move solutions into own document, plus as includes
✨ add pre-commit badge to landing page and readme
✨ add learning design section
sessions: ✨ star us callout block in landing page too
sessions: ✨ update the intro session
sessions: ✨ callout block about starring the repo
sessions: ✨ callout block about using Quarto to write notes
sessions: ✨ include a discussion activity to review previous day
sessions: ✨ add teacher note to remind about small data size
sessions: ✨ add paragraph to git ignore Quarto output
✨ split out regex and add using lubridate (#167)
✨ use DIME data in pre-workshop tasks (#145)
preamble: ✨ create the schedule with the new sessions (#139)
🗃️ add new data to use for workshop (#112)

C.3.2 Fix

sessions: ✏️ should be “wider” not “longer”
🔥 forgot to remove these reduce() references
sessions: ✏️ should have return at end
sessions: ✏️ link to cheat sheet should be in section above
sessions: ✏️ prevent these from showing in the code appendix
sessions: 🐛 use {{{ in objectives too
🐛 need to use {{{ for showing curly curly
preamble: ✏️ don’t actually need to delete dir when unzipping
sessions: ✏️ this was leftover from previous material
🐛 should not show solutions
✏️ wrong name for saved image
sessions: ✏️ this should be a reading section
✏️ clarify paragraph in robustness (#189)
✏️ small fixes to functions text (#186)
✏️ small typos in importing (#185)
✏️ small edits (#180)
✏️ changes from an editorial review (#179)
✏️ small build and aesthetic fixes
sessions: 🐛 wrong output name used
🐛 forgot to remove these chunks
✏️ missed this, always use pipe
sessions: ✏️ forgot to write to use { }
sessions: 🐛 use normal code chunks so it gets added to code appendix
sessions: ✏️ forgot to use return()
preamble: ✏️ update and fix schedule, it was slightly off
✏️ should save image the same name as the file
✏️ spell check changes
sessions: ✏️ small edits to intro session
✏️ replace ‘doc’ with ‘docs’
✏️ replace instruct with teach
preamble: 📝 update schedule to match the place’s times
preamble: ✏️ wrong time for survey
🐛 forgot to remove this eval: true
✏️ did an editing pass
🐛 remove eval: true from chunks
🐛 fix build error issues
add working link to murder mystery

C.3.3 Refactor

sessions: 🔥 remove reduce() section (#193)
sessions: ♻️ convert exercise into code-along
sessions: ♻️ simplify what next slides
sessions: ♻️ move discussion activity to previous session
sessions: ♻️ convert exercise to code-along
sessions: ♻️ remove case-when session and create final dataset in joins
♻️ update case-when session
sessions: ♻️ clarify discussion activity tasks
sessions: ♻️ make break a bit longer, and mention to go outside
♻️ add GitHub use throughout (#182)
♻️ tell to put snakecase in setup a bit further down
♻️ update the project work with another dataset (#178)
🔥 remove text from project work session
sessions: ♻️ simplify and shorten intro slides
sessions: ♻️ move workflow descriptions closer to where they are used
🔥 don’t need these in setup chunk anymore
sessions: ♻️ remove ‘…’ from reduce
sessions: ♻️ update joins session to use DIME data (#174)
sessions: ♻️ update pivots session to use DIME (#173)
📄 update license year
sessions: ♻️ pipe into functions, missed in split session
sessions: ♻️ don’t actually need to store the files anymore
sessions: ♻️ always pipe into functions, even for paths
sessions: ♻️ standardise the ends of sessions
sessions: ♻️ clarify what a string is and use it regularly
sessions: ♻️ updated split-apply-combine to use DIME (#171)
♻️ replace Instructor with Teacher
sessions: ♻️ revise functionals session to use DIME (#162)
sessions: 🔥 don’t need these in setup chunk anymore
appendix: ♻️ rearrange sections in extras doc
sessions: ♻️ new robustness session from split functions (#159)
sessions: ♻️ revise functions session to use DIME data (#158)
sessions: 🔥 remove all content related to data-raw script
sessions: ♻️ split functionals into two sessions (#157)
sessions: 🔥 don’t delete everything in Quarto
sessions: 🔥 remove use of kable()
♻️ split but nothing else, functions into two sessions (#155)
♻️ simplify code appendix section into a ## header
sessions: ♻️ shorten importing session (#154)
sessions: 🔥 remove overview diagrams, they are very outdated (#149)
sessions: ♻️ revise intro session to use DIME and mermaid diagrams (#148)
♻️ simplify learner description of landing page
🚧 more edits and drafting of pre-workshop content
sessions: 🔥 remove mention and use of spec() (#140)
♻️ revise syllabus, mainly around objectives (#137)
♻️ review and revise landing page (#122)
♻️ review and revise README (#119)

C.4 v2024.05.06 (2025-03-07)

C.4.1 Fix

remove .delim
add “using”
a component -> components
remove “…” since they are shown as “···” and not as regular periods
this code should be commented out. Closes #42
typo in function, should be intermediate. Closes #28
sleep the code for a bit since it can cause problems sometimes
need to use cat with the r3admin functions
the name was changed, so fixed it