Need documentation on how to do customization

[ocaisa]

We have a reasonable system now in place, but it's not documented how people can update it.

@mahermanns I know you are going through this so maybe you can help here? The new approach means you add your customization under
https://github.com/carpentries-incubator/hpc-intro/tree/main/episodes/files/customization
The complete configuration is under
https://github.com/carpentries-incubator/hpc-intro/tree/main/episodes/files/customization/HPCC_MagicCastle_slurm
which tells you the structure you need to use. Since the complete configuration covers everything, you only need to include things you actually want to be different (e.g., you probably don't care about the local setup but only the remote in the configuration file, you don't need all snippets updated, only some...).

The build process now logs which snippet is actually read (with a full path).

One important usability note: the Workbench does not track the child documents, so if you are developing the lesson locally and only make changes to snippets, the lesson will not re-render the relevant episode. You can force this with

sandpaper::reset_site()
sandpaper::serve()