devops/COURSE.md
2026-01-01 00:00:00 +00:00

35 lines
1.6 KiB
Markdown

---
id: devops-ale-example
title: "Continuous Integration & Delivery — DevOps (ALE Example)"
year: 2023
language: en
instructors:
- "Assoc. Prof. Panche Ribarski, PhD"
- "Assoc. Prof. Milos Jovanovik, PhD"
description: >
Example DevOps course content repo for ALE Lite v0.1. This repository hosts learning materials
and mode-aware activities as Markdown files. Instructors sync content into ALE explicitly using the
“Sync Course Content” action in the VS Code extension.
---
# Continuous Integration & Delivery — DevOps (ALE Example)
This repository is a **course content repo** for ALE Lite v0.1.
## What is in this repo?
- `materials/` — lecture materials converted to Markdown (chunked by headings for referencing).
- `activities/` — scored activities with behavior controlled by `mode` (`understanding`, `lab`, `homework`, `test`).
- `course.yml` — course metadata (machine-friendly; optional in v0.1).
- `COURSE.md` — this file (human-friendly course metadata and orientation).
## How ALE uses this repo
1. An instructor links the repo URL + branch in ALE.
2. The instructor clicks **Sync Course Content**.
3. ALE ingests `materials/` and `activities/`.
4. When new activities are detected, ALE creates corresponding grade activities in Moodle (dev/local uses moodle-mock).
## Authoring rules (v0.1)
- Each `materials/*.md` file must have YAML front matter: `id`, `title`.
- Each `activities/*.md` file must have YAML front matter: scheduling + grading fields, including `mode`.
- Activity tasks use the **multi-line block format** (Type, Points, Prompt, Refs, Rubric, Runner).