Omniadisce

What a lesson is

A normal post shows everything at once. A lesson takes the reader through a topic one step at a time: it explains a little, asks them to guess or answer, tells them at once whether they were right and why, and sums up at the end. Readers can't skip a question by accident: the Next button waits until they've answered it, or asked to see the answer.

Lessons can stand alone, or be gathered into a course: units of lessons and practice that teach a whole subject.

You don't need to know any teaching theory. The template has it built in. Fill in the boxes in order and you get a lesson with a shape that research shows works.

ReadReadGuess ReadWork outCheckReflect

The example lesson's seven steps. The same colours appear on lesson cards, in the editor and in the lesson itself.

Quick start

  1. Open the editor. Choose Write a lesson on the Lessons page, or follow the lesson link at the top of New post.
  2. Pick a template. Choose the shape that fits what you are teaching (see below). To see a finished lesson first, open Example: how supports share a load and click through its preview.
  3. Fill in the six sections in order: Basics, Goals, Hook, Key words, Steps, Recap. Every step in a template starts with a coloured line, "In this step: โ€ฆ", telling you what to write there. It isn't published.
  4. Watch the right-hand side. The Preview is the real lesson, checked by the real server, and it jumps to whichever part you are editing. Answer your own questions in it. The Checklist flags common teaching problems; it's advice, not rules.
  5. Publish. If something would stop the lesson working, a yellow line above the preview says what. Moderators review new lessons from most members before they appear in the feed, the same as other posts.

Your work is saved on this device as you type. If you close the tab, the editor offers to restore it next time. It isn't on the site until you publish.

Pick a template

Each template is a sequence of steps already in a good order. Pick by what you are teaching:

Explain a concept

For: one new idea, such as why ice floats or what interest is.

Shape: connect to everyday life, show the idea, let the reader guess about a new case, explain the rule, test it on a different case, then put it in their own words.

Why: it follows Merrill's first principles of instruction. Learning happens when you activate what people know, demonstrate, then have them apply and integrate it.

Teach a calculation

For: a formula or a method with numbers.

Shape: what the calculation is for, every symbol explained, one example fully worked, then one half-done (with a scaffold), then one alone, then a question about what the answer means.

Why: the worked-example effect. Beginners learn more from studying a solved example than from solving one cold. Removing the help a bit at a time (fading) moves them to working alone.

Fix a misconception

For: an idea most people get wrong, such as "heavier things fall faster".

Shape: ask the question first, with the popular wrong answer as a choice. Then say why that belief feels right, show where it breaks, and test with a case where the old and the new idea disagree.

Why: conceptual change. A wrong idea isn't replaced by being told the right one. It has to be seen to fail first.

Blank lesson

For: when you know what you want. Add steps from the five types in any order.

Keep the rhythm: no more than two or three Read steps before something to do.

The parts, top to bottom

The editor has six numbered sections. Here is what each becomes for the reader, and what to write.

PartThe reader seesWriteWhy it matters
1. Basics: title, topic, level, minutes, tagsThe lesson's card in the feed and on the Lessons pageA title that names the payoff, ideally a question: "Why do bridges have triangles?"People choose what to learn from the title and card alone.
2. Goals: summary, who it's for, objectivesThe opening screen: "By the end you will be able toโ€ฆ", with a circle by each goal that turns into a tick at the end2 or 3 objectives, each starting with a verb you could check: explain, calculate, predict, choose. Say what readers need to know first, even if it's nothing.Knowing where you're going helps you learn. "Understand X" can't be checked, so it gives the reader nothing to aim at.
3. Hook"Start with this" at the top of the opening screenA question, puzzle or small story from everyday life that the lesson will answer.Curiosity is what gets a reader to step 1. It's the first of Gagnรฉ's nine events of instruction: gain attention.
4. Key wordsThe first time each word appears in a step, it's dotted-underlined; tapping it shows your meaning. Also listed on the opening screen.Every word a newcomer may not know, explained in everyday words. One sentence each.Unknown words make readers stop and give up. The explanation sits right where the word is, so nobody has to scroll back.
5. StepsOne step at a time, with a coloured badge and a progress bar of dotsSee the six step types.Small steps keep the reader's working memory free for the new idea. This is segmenting.
6. Recap and what next"What you learned", the goals ticked off, how many questions they answered without being shown, and your "Next" suggestionOne short sentence per idea, ideally one per objective. Then where to go next.Summing up strengthens memory, and the tally tells readers what to revisit.

The six step types

Add steps with the coloured buttons under the step list. Move them with โ†‘ โ†“, copy one with โง‰, fold one away with โ–พ.

Read Explain one idea

Use it to explain, show an example or a worked solution. Write: a short title, the explanation (under about 150 words; add an image if it helps), and optionally a key idea: the one sentence or formula to remember, shown in a box.

Common mistake: three ideas in one step. If you write "also" or "another thing", start a new step.

Your guess The reader guesses first

Use it before you explain something surprising. The reader picks a choice and locks it in. Whatever they picked, they then see the right answer and your explanation, so there's no penalty. Write: the set-up, the question, 2โ€“6 choices (tick the right one), a line of feedback for each wrong choice, and the explanation.

Why: guessing before being told, even wrongly, makes people remember the answer better (the pre-testing effect), and it shows them what they believed before.

Common mistake: making the right answer obvious. Use the guesses real beginners make as the other choices.

Check yourself A quiz question

Use it after teaching something, on a different situation from your example. A wrong choice shows your feedback for it and the reader tries again. After two wrong tries, "Show me the answer" appears. Write: the same fields as a guess.

Why: having to recall something is far better practice than re-reading it (retrieval practice). Asking about a new case checks they can use the rule, not just repeat your example.

Work it out A number to calculate

Write: the set-up with the numbers, the question, the answer as a number, its unit, and how close counts as right (ยฑ2 % unless you change it). Add up to 4 hints, from a gentle nudge to almost the answer; one appears after each wrong try. Then write the full worked solution. The optional scaffold shows the working with the last bit missing: $R_A = 20 \times 3 / 4 = \;?$.

Common slips are spotted automatically. A wrong sign, or an answer out by 10, 100, 1000, 60 or 3.6 (the usual unit conversions), gets a specific hint: "Out by a factor of 1000: check the units."

Common mistake: a scaffold on every calculation. Give the first one a scaffold and leave it off the next, so readers end up working alone.

Think about it In the reader's own words

Use it near the end. The reader writes a sentence or two (kept on their device only), then compares with your model answer and says how close they were. Write: a prompt such as "Explain to a friend whyโ€ฆ" or "Where have you seen this at home?", and the answer you would hope for.

Why: explaining something yourself (self-explanation) shows you the gaps and makes the idea stick.

Try it A simulation or circuit, inside the lesson

Use it when readers should experiment: before you explain an idea, so they discover it, or after it, so they apply it. The step embeds a simulation, circuit or quiz post from the site, graded by its own checker. The lesson goes on once the reader solves it or reveals its solution. Write: what to do and what to watch, choose the activity by searching for it, and optionally what to notice, shown once they're done.

The activity must be posted first: make it with New post โ†’ 3D simulation (see how to build a simulation), Model lab (see the Model kit handbook) or Circuit (see how to build a circuit problem), then search for it in the step.

To build a whole lesson around one of the civil engineering labs instead, write a lab lesson: it runs beside the lab from start to finish. See how to use the labs.

Why: doing beats watching, but only with a clear task. Free play with a simulation teaches beginners little; a goal and something to look for make it a real lesson (guided discovery).

Common mistake: "Play with the simulation." Say exactly what to change and what to watch.

Writing for newcomers

Write for someone clever who knows nothing about your subject.

  • Everyday first, then the term. Describe the thing in plain words, then give its name: "the push back up from each support. Engineers call it a reaction."
  • Bold a new word the first time it appears (**reaction**), and add it to the key words.
  • Short sentences. One idea per sentence, one idea per step.
  • Concrete before abstract. A plank with a 12 kN box before $R_A = F(L-a)/L$.
  • Show, don't only tell. A picture or a worked number beats another paragraph.
  • Address the reader as "you". It reads as a conversation, and readers learn more from that than from formal text (the personalisation principle).
  • Cut the extras. Interesting asides that aren't needed for the goals make learning harder (the coherence principle). Put them in "What next".

Good questions and feedback

  • Wrong choices should be real mistakes. The best ones are the answers beginners actually give. Each one then shows exactly which misunderstanding the reader has.
  • Feedback on every wrong choice. Say what they were probably thinking and what to look at again: "That's right only when the box is exactly in the middle." This is where most of the learning happens.
  • Explain the right answer too. Readers who guessed correctly still need the reason.
  • No trick questions, no "all of the above", no double negatives.
  • Hints climb a ladder: which idea to use โ†’ which formula โ†’ which numbers go where.
  • Test each objective at least once, in a situation that differs from your example.

The checklist

The checklist beside the editor reads your lesson as you type and flags the common problems below. A ! is a suggestion: you can publish anyway.

WarningWhat to do
Make an objective observableReplace "understand / know / learn" with a verb you could check: explain, calculate, predict, choose.
Open with a hookAdd a question or story to section 3.
Start by connecting or guessingMake step 1 a Read step that links to everyday life, or a Your guess, not a quiz.
"Read" steps in a rowAfter two or three explanations, add a guess, a question or a calculation.
A step is longSplit it: one idea per step, under about 150 words.
A key word never appearsUse the word in a step, or remove it. It only becomes tappable where it's used.
Teach before you testPut a Read step before the first quiz or calculation.
A wrong choice has no feedbackWrite what someone picking it probably thought.
Add a hint / give the unitCalculations need at least one hint and a unit.
Fade the scaffoldWith two or more calculations, leave the scaffold off a later one.
Ask readers to explain it themselvesAdd a Think about it step near the end.
Length4โ€“15 steps works best; split longer lessons into a series.

The server also checks what readers need for the lesson to work: a summary, at least one objective, at least two steps including one question, and complete questions (choices, the right one ticked, a number answer, an explanation). Until those are in, the line above the preview says what's missing.

Formatting

You typeReaders see
**reaction**reaction
*the far distance*the far distance
$R_A = F(L-a)/L$$R_A = F(L-a)/L$, typeset maths
$$E = mc^2$$maths on its own line
The Image button under a text boxuploads a picture and puts it in place
An empty linea new paragraph

After publishing

  • A lesson is a post like any other: people can vote, comment, and save it to a list or a study playlist.
  • Edit it with Edit post on the lesson's page. Readers part-way through keep their place, unless you add, remove, reorder or rename steps; then they start again.
  • Read the comments. If readers say a step confused them, that step needs splitting, an example or a key word.

Log in to write a lesson

× Enlarged view