shared-teaching-materials

Deprecation note

This repository is deprecated and no longer intended for new shared teaching materials. Its original goal was to avoid duplicate maintenance across course repositories. In practice, extracting and including shared content introduced several disadvantages:

• increased complexity in maintenance, onboarding, and collaboration, particularly through Git submodules;
• reduced effectiveness of AI-assisted development because related content and context are distributed across multiple repositories;
• course repositories that are less self-contained and therefore harder to publish.

Going forward, teaching materials should generally remain within their respective course repositories. Similar content may be synchronized selectively when the benefits justify the duplication.

Repository for teaching materials shared across courses.

The Quarto website lists available material areas and includes usage instructions for adding this repository as a submodule, including shared fragments, and managing shared image paths.

Quick start

Add the repository as a submodule at the project root:

git submodule add https://github.com/fs-ise/shared-teaching-materials.git shared-teaching-materials

Include the Analytics "Rise of Analytics" deck fragment in a course slide deck with:

{{< include ../shared-teaching-materials/analytics/_rise_of_analytics.qmd >}}

See the website source files for the complete instructions:

• index.qmd lists material areas and include shortcuts.
• usage.qmd contains the full setup and contribution instructions.

Generated files

The following generated files and directories may appear after rendering the Quarto website or notebook-backed pages and should not be committed:

_freeze/
_site/
analytics/rise-of-analytics.quarto_ipynb_1
index.quarto_ipynb_1

License

The teaching contents are licensed under the Creative Commons Attribution 4.0 International License unless noted otherwise.