Skip to content

Comments

Add 'Reproducible Reports with Quarto' Episode#136

Merged
nickyjgarland merged 2 commits intomainfrom
feat/add-quarto-episode
Feb 19, 2026
Merged

Add 'Reproducible Reports with Quarto' Episode#136
nickyjgarland merged 2 commits intomainfrom
feat/add-quarto-episode

Conversation

@jt14den
Copy link
Member

@jt14den jt14den commented Jan 22, 2026

This PR adds a new capstone episode teaching Quarto for reproducible reporting, addressing the modern infrastructure needs of The Carpentries.

Changes

  • New Episode: '05-reproducible-reports.Rmd' covers creating, editing, and rendering Quarto documents.
  • Configuration: Added the new episode to 'config.yaml'.
  • Validation Fixes:
    • Fixed uninformative link text ('here') in episodes 01 and 04.
    • Fixed a malformed fenced div in episode 04.

Issues Addressed

- Add new episode '05-reproducible-reports.Rmd' teaching Quarto basics (Fixes #129).
- Update 'config.yaml' to include the new episode.
- Fix accessible link text in '01-intro-to-r.Rmd' and '04-data-viz-ggplot.Rmd'.
- Fix typo in fenced div in '04-data-viz-ggplot.Rmd'.
@github-actions
Copy link
Contributor

github-actions bot commented Jan 22, 2026

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

  • 🎯 correct output
  • 🖼️ correct figures
  • ❓ new warnings
  • ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/LibraryCarpentry/lc-r/compare/md-outputs..md-outputs-PR-136

The following changes were observed in the rendered markdown documents:

 01-intro-to-r.md                                   |    5 +-
 04-data-viz-ggplot.md                              |    4 +-
 05-reproducible-reports.md (new)                   |  246 ++
 config.yaml (new)                                  |   86 +
 ...t-rendered-boxplot-exercise-subcollection-1.png |  Bin 49702 -> 49119 bytes
 ...a-viz-ggplot-rendered-boxplot-with-points-1.png |  Bin 43026 -> 43737 bytes
 ...data-viz-ggplot-rendered-unnamed-chunk-14-1.png |  Bin 40019 -> 39708 bytes
 fig/04-data-viz-ggplot-rendered-violin-plot-1.png  |  Bin 38803 -> 38647 bytes
 ...le-reports-rendered-plot-high-usage-1.png (new) |  Bin 0 -> 48979 bytes
 md5sum.txt                                         |    7 +-
 renv.lock (new)                                    | 3954 ++++++++++++++++++++
 11 files changed, 4294 insertions(+), 8 deletions(-)
What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2026-01-22 03:05:23 +0000

- Replace knitr '{{r}}' syntax with standard Markdown four-backticks for displaying code chunks.
- Update the example setup chunk to load and clean raw data internally, avoiding dependencies on intermediate files from previous episodes.
github-actions bot pushed a commit that referenced this pull request Jan 22, 2026
@nickyjgarland nickyjgarland self-assigned this Feb 3, 2026
@jt14den
Copy link
Member Author

jt14den commented Feb 18, 2026

@nickyjgarland wrote this episode for quarto per #136, can you review?


### 2. Markdown Text

The white space is where you write your narrative. You use **Markdown** syntax to format text.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Small addition could be referencing a markdown guide (e.g. https://www.markdownguide.org/ - for further information), as there doesn't appear to be anything Carpentries related we could link to.

Copy link
Contributor

@nickyjgarland nickyjgarland left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great and integrates well into the existing lesson. Added a small comment about potentially pointing towards some markdown resources, as the lesson doesn't specifically cover md.

Another improvement could be to add some Quarto specific resources into R Resources section

Suggestions:
Comprehensive guide to using Quarto
Quarto section in 'R for Data Science'

@jt14den
Copy link
Member Author

jt14den commented Feb 19, 2026

@nickyjgarland can you merge if you are cool with it?

@nickyjgarland nickyjgarland merged commit 1de04b1 into main Feb 19, 2026
7 of 8 checks passed
github-actions bot pushed a commit that referenced this pull request Feb 19, 2026
Auto-generated via `{sandpaper}`
Source  : 1de04b1
Branch  : main
Author  : Nicky Garland <58030201+nickyjgarland@users.noreply.github.com>
Time    : 2026-02-19 18:59:26 +0000
Message : Merge pull request #136 from LibraryCarpentry/feat/add-quarto-episode

Add 'Reproducible Reports with Quarto' Episode
github-actions bot pushed a commit that referenced this pull request Feb 19, 2026
Auto-generated via `{sandpaper}`
Source  : f958d94
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2026-02-19 19:02:56 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : 1de04b1
Branch  : main
Author  : Nicky Garland <58030201+nickyjgarland@users.noreply.github.com>
Time    : 2026-02-19 18:59:26 +0000
Message : Merge pull request #136 from LibraryCarpentry/feat/add-quarto-episode

Add 'Reproducible Reports with Quarto' Episode
github-actions bot pushed a commit that referenced this pull request Feb 19, 2026
Auto-generated via `{sandpaper}`
Source  : f958d94
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2026-02-19 19:02:56 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : 1de04b1
Branch  : main
Author  : Nicky Garland <58030201+nickyjgarland@users.noreply.github.com>
Time    : 2026-02-19 18:59:26 +0000
Message : Merge pull request #136 from LibraryCarpentry/feat/add-quarto-episode

Add 'Reproducible Reports with Quarto' Episode
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Use Quarto

2 participants