How to use Who Is Wilson?

Getting Started

Sign in at whoiswilson.app using your Google account, Microsoft account, or an email and password. No installation required — everything runs in your browser.

For Quiz Authors

Using the Built-in Editor

The easiest way to create a quiz is with the built-in editor. From your dashboard, click Create Quiz to open the editor.

• Write your quiz on the left — see it rendered on the right in real time
• Use the toolbar to insert question templates (single choice, multi choice, true/false, sequence)
• Validation errors appear instantly in the preview panel
• Click Download .md to save a local copy of your quiz anytime
• Click Create Quiz when you're ready to publish

Writing a Quiz

Quizzes are written in a simple text format. A settings block at the top defines the quiz title and options, followed by your questions. You can use the built-in editor or any text editor you like. Here's a minimal example:

---
title: "My First Quiz"
tags: [sample]
---

##### Question q001
type: single_choice
correct: [b]

What colour is the sky on a clear day?

A. Green
B. Blue
C. Red
D. Yellow

###### Explanation
The sky appears blue due to Rayleigh
scattering of sunlight.

Quiz Settings

The settings block at the top of the file (between the --- lines) controls quiz behaviour:

• title (required) — the quiz name displayed to students
• tags — labels to organise quizzes by subject, e.g. [maths, year10] or [first-aid, safety]
• time_limit — time in minutes; omit for untimed quizzes
• allow_overrun — if true, students can continue after the timer expires (default: true)
• random_order — if true, questions appear in a different random order for each attempt

Question Types

Question Format

Each question block follows this pattern:

##### Question q001
type: single_choice
correct: [b]

The question text goes here. Formatting is
supported including **bold**, `code`, and tables.

A. First option
B. Second option
C. Third option
D. Fourth option

###### Explanation
This text is shown after the student answers.
Explanations are optional but recommended.

Adding Images

Reference images in your quiz using ![[filename.png]]. Attach the image files when you upload the quiz.

• Accepted formats: PNG, JPG, GIF, WebP, SVG
• Maximum file size: 2 MB per image
• Referenced images that aren't uploaded will show a clear error with the line number

Uploading a Quiz

1. Sign in and go to your dashboard
2. Click Upload Quiz and select your .md file
3. If your quiz references images, click Add images and select them
4. Click Upload — the quiz is validated immediately and any errors are shown

Updating a Quiz

Open the quiz from your dashboard, click Upload New Version, and select the updated file. The version number increments automatically. Students who started an attempt on the old version will finish on that version.

Enrolling Students

1. Open a quiz from your dashboard
2. In the Enrolled Students section, enter the student's email and click Enrol
3. If the student has an account, they're enrolled immediately
4. If not, a pending invitation is created — they're automatically enrolled when they sign up

For Students

Taking a Quiz

1. Sign in — quizzes assigned to you appear in the Assigned to You section
2. Click Start to begin an attempt
3. Answer questions one at a time; you can change answers before submitting
4. Click Complete when finished to see your score and detailed feedback

Reviewing Results

After completing a quiz, review each question with the correct answer, your answer, and the explanation. You can filter to show only incorrect answers, and retake quizzes as many times as you like.

Common Patterns

"Select all that are true" questions

Use multi_choice for questions where students evaluate multiple statements:

##### Question q005
type: multi_choice
correct: [a, c]

Which of the following statements about
Azure AD are true? Select all that apply.

A. Azure AD supports SAML authentication
B. Azure AD requires on-premises AD
C. Azure AD supports MFA
D. Azure AD only works with Microsoft 365

###### Explanation
Azure AD supports SAML and MFA natively.
It does not require on-premises AD and works
with many third-party applications.

Tips

• Start with a small quiz (5–10 questions) to get comfortable with the format
• Use explanations generously — they're the most valuable part of the learning experience
• Use random_order: true to prevent students from memorising the sequence
• Use time_limit to simulate exam conditions once students are ready
• Questions support text formatting — use tables, code blocks, and bold text to make questions clear