Skip to content

Assessment Template

Copy this structure into docs/self-assessment/<module>-quiz.md and replace the bracketed placeholders. Use it for module quizzes, exercises, and rubrics.

# Quiz — [Module name]

!!! info "At a glance"
    - **Module:** [NN — Module name]
    - **Questions:** [NN]
    - **Estimated time:** [NN minutes]

## How to use this quiz

Answer every question in writing **before** revealing the answers. Compare your reasoning,
not just your conclusion — a correct answer reached by luck teaches you nothing.

---

## Part A — Recall and vocabulary

**A1.** [Question with one unambiguous answer.]

??? note "Answer"
    [Answer with a one-line justification.]

**A2.** [Question.]

??? note "Answer"
    [Answer.]

## Part B — Application

**B1.** [A short scenario requiring the student to apply a concept.]

??? note "Answer"
    [Model answer, and note any reasonable alternatives.]

**B2.** [Question.]

??? note "Answer"
    [Answer.]

## Part C — Judgement

**C1.** [An open question with more than one defensible answer.]

??? note "Answer"
    [Explain the reasoning expected, and state explicitly that well-argued alternatives are
    acceptable.]

---

## Scoring guide

| Section | Points | What it checks |
| --- | --- | --- |
| A | [NN] | Vocabulary and recall |
| B | [NN] | Application to a situation |
| C | [NN] | Reasoning and judgement |

**Interpretation:** [Explain what a given score suggests about whether to revisit the module.]

## If you scored low

Revisit [specific lesson links], then retake the quiz.

Authoring rules

  • Every answer is hidden behind ??? note "Answer" so the quiz is a real test.
  • Part C must not have a single right answer. Judgement questions reward reasoning.
  • Justify answers, don't just state them — the justification is the teaching.
  • Link back to the lesson for each topic so a student who struggles knows where to go.
  • Add the quiz to mkdocs.yml nav and to docs/self-assessment/index.md.