Skip to content

Reformat Episode 4 and add instructor note#203

Open
alex-ball wants to merge 1 commit intoLibraryCarpentry:mainfrom
alex-ball:patch-142
Open

Reformat Episode 4 and add instructor note#203
alex-ball wants to merge 1 commit intoLibraryCarpentry:mainfrom
alex-ball:patch-142

Conversation

@alex-ball
Copy link
Copy Markdown
Contributor

This PR adds an instructor note to Episode 4, containing a suggestion for how to adapt the review exercise when teaching the lesson over Zoom. The key differences in this approach are that the bulk of exercise is done in one large group, with everyone sharing access to a common virtual whiteboard, and it finishes off with some individual work on the same board.

Many thanks to you, @PhilReedData, for contributing the suggestion; please take a look and let me know how to improve this version of it.

In addition, this PR makes some adjustments to the regular version of the review exercise. Reading through the page again, I struggled with the logic of how the text before the 'Exercise' header related to the text after it – they seemed to be two different versions of the same thing. To straighten things out, I've used the new instructor note as inspiration and reformulated the two versions of the group work into a single challenge block: the first bullet list now reflects the order used in the Zoom version; and I've reframed the 'Visualising Git' exercise as a set of prompts or nudges for thinking about the second half of the challenge, and formatted it as a hint block. I think it works better like that.

Resolves #142.

The instructor note contains specific advice on running the episode
over Zoom and relates to LibraryCarpentry#142.
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 16, 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-git/compare/md-outputs..md-outputs-PR-203

The following changes were observed in the rendered markdown documents:

 04-review.md | 39 ++++++++++++++++++++++++++++++++++-----
 md5sum.txt   |  2 +-
 2 files changed, 35 insertions(+), 6 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-04-16 15:56:02 +0000

github-actions bot pushed a commit that referenced this pull request Apr 16, 2026
Copy link
Copy Markdown

@PhilReedData PhilReedData 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 to me, well done and thank you

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.

Suggestion for online review activity

3 participants