====== Quiz Builder ======

===== Overview =====

The LEAST Quiz Builder creates formative and summative assessments. Quizzes are attached to lessons or courses and can be used for self-assessment or graded evaluation.

===== Creating a Quiz =====

  - Navigate to your class -> **Assessments -> New Quiz**
  - Enter a title and description
  - Set: pass mark (%), time limit (optional), maximum attempts
  - Add questions (see below)

===== Question Types =====

^ Type ^ Description ^
| Multiple Choice | One correct answer from 2-6 options |
| Multiple Select | One or more correct answers |
| True / False | Binary choice |
| Short Answer | Free-text response (manually marked) |
| Essay | Long-form text response (manually marked) |

===== Adding Questions =====

  - In the quiz editor, click **Add Question**
  - Select the question type
  - Enter the question text
  - For multiple choice / select: enter options and mark the correct answer(s)
  - Set the point value (default: 1 point)
  - Optional: add an explanation shown after the learner answers

===== Question Bank =====

Frequently reused questions can be saved to the **Question Bank**:
  - When creating a question, tick **Save to Question Bank**
  - Reuse from the bank by clicking **Insert from Question Bank** in any quiz

The Question Bank is also used as the source for Pool Quizzes (see below).

===== Pool Quiz (Randomised Draw) =====

A **Pool Quiz** draws a random subset of questions from a Question Bank category each time a learner starts. Every session presents different questions in a different order, preventing rote memorisation of a fixed question set.

==== Setting Up a Pool Quiz ====

  - Populate a **Question Bank category** with MCQ questions (minimum: more questions than the draw size)
  - Open the quiz and navigate to **Quiz Settings -> Pool Config**
  - Select the source **Question Bank category**
  - Set the **draw size** (how many questions to present per session)
  - Enable **Randomise question order** and **Randomise answer order** (recommended)
  - Save

When a learner opens a quiz with a pool configuration, they are directed to the pool quiz runner automatically.

==== How It Works for Learners ====

  * A fresh question set is drawn at the start of each new session
  * Immediate per-question feedback is shown after each answer
  * The correct answer is revealed on incorrect responses, along with any explanation you provided when authoring the question
  * Score accumulates live throughout the session

==== Attempt Controls ====

Pool quizzes respect the same attempt limits and cooldown settings as standard quizzes -- configured in the main quiz settings panel.

==== Comparison: Standard Quiz vs Pool Quiz ====

^ Feature ^ Standard Quiz ^ Pool Quiz ^
| Question source | Fixed list | Random draw from category |
| Answer feedback | Configurable (immediate / end of quiz / not shown) | Always immediate, per question |
| Session uniqueness | Same questions each attempt | Different questions each session |
| Marking | Auto or manual | Auto-marked MCQ only |

===== Marking Schemes =====

  * Auto-marked: multiple choice, multiple select, true/false
  * Manual mark: short answer and essay questions appear in the educator marking queue
  * Partial credit: optional on multiple select questions

===== Quiz Settings =====

^ Setting ^ Options ^
| Attempts | Unlimited / fixed number |
| Time Limit | None / minutes |
| Question Order | Fixed / randomised |
| Answer Feedback | Immediate / end of quiz / not shown |
| Pass Mark | Percentage (for pass/fail display) |

===== Viewing Results =====

  - Navigate to **Educator -> Assessments -> Results**
  - View per-learner scores, attempt history, and question-level breakdown
  - Export results as CSV for external reporting