Method

How these lessons were written

This page describes the rules the lessons follow, where those rules come from, and how each lesson was checked. At the end it also says where the lessons fall short.

Who the reader is

The lessons are written for a working software engineer who reads code and knows school maths. ML and statistics terms are new to this reader. The goal is to understand the course technically, not just at the surface, and in the end to read the Stanford slides without help.

The teaching rules

  1. From first principles. Each new term is explained where it first appears. A term from an earlier lesson opens its definition when you click it.
  2. The concept first, then the failure. Each step first says what the new idea is and what it does. Then it applies the idea to a real failure, such as BM25 ranking the old forum post above the queue log.
  3. No analogies, a small version of the real system. All lessons run on the same small corpus: a course's office hours page, queue log, syllabus, an old 2024 forum post and the Homework 1 announcement. So the numbers stay consistent from one lesson to the next.
  4. Numbers before formulas. Every formula is first worked by hand on small numbers. Then each symbol in the formula is tied to those numbers.
  5. Maths taught where it is used. Logarithms, matrix products and rates of change all come in from school level, with numbers, and with a check wherever possible.
  6. A ladder. Each lesson opens with a list of steps. Under each step it says what you will be able to do after it, so you can skip what you already know.
  7. Connected sentences. Each sentence starts from what came before, and new information comes at the end. No line exists only to land a point, and headings name their content.
  8. The right form for each kind of content. Explanations are paragraphs, steps are numbered lists, and comparisons are tables. The most important sentence of each part is in bold.
  9. Think first. In many places the answer is hidden, so that you work it out yourself first.

The Hindi pages follow Spoken Hindi rules: Hindi words in Devanagari, technical terms in English letters, sentences of at most 25 words, and active voice. The English pages use plain English, and both languages carry the same numbers and sections.

Easy and dense

The easy version holds only the core: one worked calculation for each idea, and the maths that calculation needs. The dense version contains the whole easy lesson word for word. It then marks “From here: the Stanford level”, followed by steps that tie every symbol on the slides to numbers, read the paper's real setup and experiments, and finally have you read the slide images yourself, with questions.

Where the rules come from

Each rule rests on research or a well-known book about teaching or writing:

IdeaSourceIn the lessons
A sentence should start with what the reader already knows, and put new information at the end.Gopen and Swan (1990), “The Science of Scientific Writing”. Joseph Williams, “Style”.Connected sentences
Readers new to a topic need connected text. When the connecting words are cut, they get stuck.McNamara et al. (1996), “Are Good Texts Always Better?”Words like because, so and which means are kept
Holding a label and its meaning in mind costs effort. Novices learn faster from worked examples.Sweller's cognitive load theoryPassages named by content, not P3-style labels, and a worked calculation for each idea
New material settles more easily into a structure given up front.Ausubel's advance organizerThe ladder at the top, and the concept first
People learn better from conversational text.Mayer's personalization principleThe pages address the reader directly
Trying before seeing the answer makes it stick.The generation effect (Slamecka and Graf, 1978) and the pretesting effect (Richland, Kornell and Kao, 2009)“Think first” questions
If the writer does not do the work of explaining, every reader has to do it.Olah and Carter (2017), “Research Debt”The dense version's full path to the slides
Simple means ordinary words and plain sentences.Paul Graham, “Write Simply”Spoken Hindi and plain English

How the writing went

How each lesson was checked

CheckWhat it catches
Number scriptEach lesson's own script recomputes every number and matches it against the page text.
Spoken Hindi checkerHindi sentences over 25 words, passive voice, formal words and Roman Hindi.
Lesson checkerBroken links and anchors, glossary terms, the switch, and matching sections in the Hindi and English pages.
Phone checkPages, tables, formulas and images on a 360 px wide screen.
Source marks“From the paper” on facts from a paper, and “my” on the lesson's own examples.

Where the lessons fall short