Set of customization hooks for different topics#480
Conversation
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:
Rendered Changes🔍 Inspect the changes: https://github.com/carpentries-incubator/hpc-intro/compare/md-outputs..md-outputs-PR-480 The following changes were observed in the rendered markdown documents: 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-02-05 09:30:40 +0000 |
| separate window, then press `P` to toggle **p**resentation mode. | ||
|
|
||
|
|
||
| ```{r, echo=FALSE, results='asis'} |
There was a problem hiding this comment.
Let's take advantage of the fact that this is R and insert comments here to explain the existence/purpose of this (and indeed all snippets!). It could also be somehow signified in the name of the Rmd that is intended for customization/localization purposes (like with a _localization in the filename, or a special subdirectory within snippets).
There was a problem hiding this comment.
I understand the need for this but I am not a big fan of placing them in specific locations within the lesson. We will end up with similar items peppered everywhere. I would be more inclined to support placeholders at the beginning and end of each episode so that people have more freedom to tweak the scope.
There was a problem hiding this comment.
I did suggest a while ago that each lesson should have preamble and postamble snippets, but there was pushback on this as it could lead to local customisations taking priority over upstream contributions.
The Introduction to HPC provides basic knowledge on how to navigate HPC systems.
At different times in the episodes it would be helpful to add local information to enable a "that is how it is in general --- this is how it is on the local platform" material.
This PR adds empty snippets to the default customization (HPCC_MagicCastle_Slurm) and integrates them into the episodes.