Home

Welcome to our Wiki!

This repository hosts the code for our tutorials website.

This website is written in Markdown and built with MkDocs. All documentation source files are under docs/. Tutorials are stored under docs/tutorials/.

New tutorials (2025 onwards) are being built with The Carpentries Workbench. For that, we have a custom UoM fork of Varnish, the package that provides the interface template for The Workbench.

For contributions to the tutorials website itself, see the mkdocs.yml file, which contains the sidebar links, or the index.md file, with the landing page text.

---

To contribute by creating a new workshop, please follow see the Contributing Instructions.

To create a Markdown-based workshop, use the Markdown template.

To create an RMarkdown-based workshop, use the RMarkdown template. RMarkdown workshops allow execution and compilation of code to render the final workshop website.

On the template repository, click "Use this template" on the top-right corner.

---

Pages

• Contributing: setting up your machine, creating a workshop, developing episodes.
• Renv and dependencies: how package management works in a Workbench lesson, running Python via reticulate, and what to do when sandpaper seems to disappear.