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.

For Quiz Authors

Writing a Quiz

Quizzes are written in plain Markdown with a YAML header. You can use any text editor. Here is 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.

Frontmatter Options

The YAML block at the top of the file controls quiz settings:

• title (required) -- the quiz name displayed to students
• tags -- a list of tags for organisation, e.g. [azure, networking]
• 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

Four question types are supported:

• single_choice -- one correct answer from multiple options
• multi_choice -- two or more correct answers; student must select all to score
• true_false -- a statement that is either true or false
• sequence -- arrange options in the correct order

Question Format

Each question block follows this pattern:

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

The question text goes here. Markdown 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 the notation ![[filename.png]]. When you upload the quiz, attach the image files alongside the Markdown file.

• Accepted formats: PNG, JPG, GIF, WebP, SVG
• Maximum file size: 2 MB per image
• If you reference an image that is not uploaded, you will see 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 it on that version.

Enrolling Students

1. Open a quiz from your dashboard
2. In the Enrolled Students section, enter the student's email address and click Enrol
3. If the student already has an account, they are enrolled immediately
4. If not, a pending invitation is created -- they will be 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, you can review each question with the correct answer, your answer, and the explanation. Retake quizzes as many times as you like.

Tips

• Start with a small quiz (5-10 questions) to get comfortable with the format
• Use explanations generously -- they are 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