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.ymlnavand todocs/self-assessment/index.md.