charles-learn-anything
Goal
In 4 to 6 minutes of narration, the learner understands one topic well enough to explain it and get the quiz right. The lesson is a page on their computer that opens in Chrome. Building it takes about 10 minutes of your time: the kit already does the page, the player and the voice, so you only write the lesson and at most a few small demos.
Lessons live in ~/Learn/<topic-slug>/: lesson.json, optionally widgets.js (the demos) and assets/ (images). examples/anti-aliasing/ is a complete lesson to copy from.
Steps
1. Pin down one topic and its promise
Write the lesson's promise in one sentence: "Why slanted lines look jagged on screens, and how computers smooth them." If the request is a whole field ("teach me machine learning"), take the first 6-minute layer, say that's what this lesson covers, and offer the next layer at the end.
Why: a lesson that tries to cover a field teaches none of it. One layer learned properly sticks and makes the next one easy.
2. Outline 4 to 7 steps, concrete first
- One idea per step, and the step's title is the idea as a statement ("One check per pixel makes a staircase"), never a label ("Sampling").
- Order them: what they can already see or know, then how it works, then the fix or the variations, then where they'll meet it.
- Narration is at most 900 words in total (6 minutes at 1x) and at most 150 words per step (about a minute).