Example session

Introduction

Prof. Dr. Gerit Wagner

Welcome

This example deck demonstrates reusable slide conventions for a teaching repository.

Use one slide deck per session.

• explain the repository structure;
• distinguish metadata, generated data, and teaching content;
• identify which files to change when creating a new course.

Format examples

Teaching goals

The teaching goal is to make repository conventions visible before students or instructors start adding course-specific material.

Must learn. Course repositories stay maintainable when repeated structural information lives in one metadata source.

Core concept

Essential concept. A teaching repository separates reusable infrastructure, configurable metadata, generated data, and course-specific content.

Working with columns

Instructor focus

• State the learning goal.
• Connect to prior knowledge.

Student focus

• Identify assumptions.
• Ask clarification questions.

Discussion prompt

Discuss. Which information belongs in course.yml, and which information belongs in a session file?

In-class exercise

Exercise. Open course.yml and identify the fields that must change for a new course.

Optional learning note

Optional. Quarto projects support shared metadata, which keeps repeated document options in one place (Posit, n.d.).

Summary

Take away. Use course.yml for course metadata, one source file per session artifact, generated YAML for schedule data, and Quarto for publication.

Before the next session, replace the example content with course-specific material and keep reusable infrastructure generic.

References

Posit. n.d. “Quarto Projects.” Accessed July 8, 2026. https://quarto.org/docs/projects/quarto-projects.html.