The Craft of Teaching
From accidental teacher to deliberate multiplier.
A teaching curriculum for engineers — how humans actually learn, the curse of knowledge, backwards design, retention engineering, one-on-one teaching through code review and pairing, writing and speaking and video for learners, workshops and curriculum-scale architecture, knowledge products as a business, and the ethics of teaching in public.
-
1
The Teaching You Already Do — the Compounding Audit
-
2
How Humans Actually Learn — Cognitive Science Foundations
-
3
The Curse of Knowledge
-
4
Backwards Design & Assessment — Outcomes First, Deliverables Over Quizzes
-
5
Retention Engineering — Spaced Repetition & Active Recall
-
6
One-on-One Teaching — Code Review, Pairing, Mentoring
-
7
Writing for Learners — From README to Body of Work
-
8
Teaching Through Speaking — Talks, Meetups, Conferences
-
9
Teaching Through Video — The Hard Medium Most Engineers Avoid
-
10
Teaching Across the Technical/Non-Technical Divide
-
11
Workshops, Courses & Curriculum-Scale Architecture
-
12
Knowledge Products as a Business — Pricing & Format Decisions
-
13
Ethics & Edge Cases of Public Teaching
-
14
The Long Arc — Building a Public Practice & the 5-Year Capstone
The Craft of Teaching — Media Track (Public Edition) #
Companion track to the Craft of Teaching Mastery Curriculum (Modules 0–13).
For: working software engineers — including those who write docs and READMEs, review code, give talks, make videos, or are weighing a paid course or newsletter.
A media track is a rest track. You are not supposed to complete it. Reach for it when the spine's deliverables are too much and what you need is somebody else's careful engagement with how learning actually works, what teaching well costs, and what honest knowledge products look like. Watching twenty hours of conference talks does not make you a better speaker; giving one talk does. Use this as input between outputs.
Two tag systems, both preserved:
| Mood | Meaning |
|---|---|
| Inspiring | Teachers and engineer-teachers who built compounding craft honestly |
| Cautionary | What cargo-cult course content, cruelty-pedagogy, or romanticized teaching costs |
| Mind-bending | Reframes the territory — desirable difficulties, retrieval, the medium itself |
| Fun | Watchable first; teaching literacy embedded under the entertainment |
| Dark | Failed products, MOOC data, heavy themes; not for a hard week alone |
| Historical | Long-arc educator stories and engineering history |
| Technical | Research-grade content or direct applicable craft, named frameworks |
| Grade | Meaning |
|---|---|
| Empirical | Evidence-grade — peer-reviewed research, meta-analyses, validated findings |
| Practitioner | Operator's-eye-view — lived experience, valuable but context-bound |
| Mixed | Both, or popular synthesis needing a critical lens |
QUICK PICKS BY MOOD #
When you know the mood but not the title, start here.
| Mood you need | First reach | Also good |
|---|---|---|
| Inspiring | Sandi Metz, All the Little Things | Randy Pausch, Last Lecture; Stand and Deliver |
| Cautionary | Eric Mazur, Confessions of a Converted Lecturer | Whiplash; Forte cohort-drama coverage |
| Mind-bending | Bret Victor, Inventing on Principle | One Robert Bjork lecture; Rich Hickey, Simple Made Easy |
| Fun | Gary Bernhardt, Wat (4 min) | Damian Conway; any Fireship in 100 Seconds |
| Dark | MOOC completion-rate research | Half Nelson; Jonathan Blow, Preventing the Collapse of Civilization |
| Historical | Code Rush | Salman Khan TED 2011; Mr. Holland's Opus |
| Technical | Patrick Winston, How to Speak | Larry McEnerney; Daniele Procida on Diátaxis |
MODULE 0 — The Teaching You Already Do (the audit) #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Cal Newport — Deep Work / career-capital talks | Talks at Google, 2016+ | 45–90 min | Technical | Practitioner | The craftsman-mindset frame applied to the teaching you already do — docs, reviews, onboarding. |
| Patrick McKenzie (patio11) — Don't Call Yourself a Programmer + long-form interviews | 2012+ | 60–120 min | Mind-bending | Mixed | How you name your existing teaching surface is upstream of whether it compounds. |
| Justin Welsh — solo-creator interviews | 2021+ | 30–60 min | Cautionary | Practitioner | Critical lens required. The audience-mechanics content is real; the "$5M solo creator" register is performance. Extract the former. |
| David Perell — free essays on writing online | perell.com, 2020+ | 30–60 min | Technical | Practitioner | Critical lens. The writing-online-compounds thesis is correct; the cohort funnel is one expensive way to act on it. |
MODULE 1 — How Humans Learn #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Robert Bjork — desirable-difficulties lectures | UCLA Bjork Lab archive, 2010+ | 45–90 min | Mind-bending | Empirical | The originator, in his own voice. What produces learning feels harder; what feels easy produces illusion of competence. The single most important free archive here. |
| Daniel Willingham — Why Don't Students Like School? talks | Talks at Google, AFT, 2010+ | 45–60 min | Technical | Empirical | The clearest popular-press cognitive scientist working. Most teaching ignores this evidence the way most code ignores the distributed-systems literature. |
| Roediger & McDaniel — Make It Stick author talks | APS, WashU, 2014+ | 45–90 min | Mind-bending | Empirical | Retrieval is not a study technique; retrieval IS the learning. |
| Pashler et al. — learning-styles critique, explained | 2008 paper + later explainers | 30–60 min | Mind-bending | Empirical | The paper that closed the "learning styles" debate. Folk pedagogy often fails when tested. |
| Eric Mazur — Confessions of a Converted Lecturer | Harvard, ~2010 | 1 hr | Cautionary | Empirical | A physicist proving, in painful detail, that two decades of his lectures weren't teaching. Watch this one. |
| Barbara Oakley — Learning How to Learn (TEDx) | 2014 | 18 min | Fun | Mixed | The compressed version; watch before deciding whether to read the book. |
| Veritasium — The 4 Things It Takes to Be an Expert | 2022 | 12 min | Fun | Mixed | Pop-science Ericsson; useful ammunition against fixed-talent thinking. |
| Whiplash | 2014 film | 107 min | Cautionary, Dark | Mixed | Watch as a study of the pedagogy of cruelty, not a model. "Great teachers are harsh" is survivor-bias misread; desirable difficulty is NOT cruelty. |
| Dead Poets Society | 1989 film | 128 min | Cautionary | Mixed | Critical lens. The film conflates dramatic teaching with effective teaching — exactly the conflation this curriculum refuses. |
MODULE 2 — The Curse of Knowledge #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Steven Pinker — Linguistics, Style and Writing in the 21st Century | 2015 | 1.5 hr | Technical | Empirical | The Sense of Style argument live. The curse of knowledge named as the engineer's most expensive writing failure. |
| Felienne Hermans — Programming Is Writing Is Programming | conference talks, 2017+ | 30–45 min | Mind-bending | Mixed | Compressed The Programmer's Brain. How code reading actually loads working memory. |
| Patrick McKenzie — talks on "boring" technical systems | 2012+ | 30–60 min | Technical | Practitioner | The art of explaining a system you know too well to people who don't. |
MODULE 3 — Backwards Design & Assessment #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Grant Wiggins (archive) + Jay McTighe — Understanding by Design lectures | ASCD, 2005+ | 45–90 min | Technical | Practitioner | Outcomes first, evidence second, content last — the order is the discipline. |
| Cathy Moore — Map It / Action Mapping talks | cathy-moore.com, 2017+ | 30–60 min | Technical | Practitioner | Start with the action the learner must take; everything else serves it. The cleanest "deliverables over quizzes" voice. |
| Julie Dirksen — Design For How People Learn talks | Learning Solutions, 2015+ | 45–60 min | Technical | Practitioner | Instructional design sized for non-academics; engineers can pick it up directly. |
| Dylan Wiliam — Embedded Formative Assessment talks | ETS, ASCD, 2010+ | 45–60 min | Technical | Empirical | The assessment IS the contract. If the assessment is weak, the course sells something it doesn't deliver. |
| John Hattie — Visible Learning talks | 2012+ | 45–60 min | Mind-bending | Mixed | Calibration needed — the effect-size methodology has critics; the underlying layer (some methods consistently work, others don't) holds. |
| Wes Kao — completion-vs-capability essays | 2021+ | 30–60 min | Cautionary | Practitioner | What gets measured determines what gets built. Graduate-shipped-real-thing beats completion rate. |
| Stand and Deliver | 1988 film | 103 min | Inspiring | Mixed | Holding underestimated learners to the standard the evidence can sustain. Lowering the bar to be kind is the failure mode. |
MODULE 4 — Retention Engineering #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Andy Matuschak — Tools for Thought + mnemonic-medium walkthroughs | 2019+ | 30–180 min | Mind-bending | Practitioner | Retention as a designable property, not a learner responsibility. The engineer-friendly contemporary canon. |
| Michael Nielsen — Augmenting Long-term Memory + interviews | augmentingcognition.com, 2018+ | 30–60 min | Mind-bending | Practitioner | Anki used seriously is a memory prosthetic, not a study aid; the difference is design discipline. |
| Piotr Wozniak — SuperMemo writings + interviews | supermemo.guru, 2010s+ | varies | Mind-bending | Empirical | The research substrate under every modern spaced-repetition system. Dense, brilliant, idiosyncratic. |
| Henry Roediger — test-enhanced-learning research talks | APS, 2010+ | 45–60 min | Technical | Empirical | The retrieval-practice meta-analyses in researcher voice. |
| Akeelah and the Bee | 2006 film | 112 min | Fun, Inspiring | Mixed | Disciplined practice + spaced rehearsal + meaningful deliverable, dramatized. |
MODULE 5 — One-on-One Teaching (code review, pairing, mentoring) #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Tanya Reilly — Being Glue | 2019 talk + post | 30 min | Mind-bending | Practitioner | Watch the talk; read the post; re-read the post. The invisible teaching work named. |
| Will Larson — engineering-management talks | 2018+ | 30–45 min | Technical | Practitioner | The complementary half of Reilly's frame, tilted toward strategy and sponsorship. |
| Pat Helland — Mind Your State for Your State of Mind | 2018+ | 45 min | Inspiring | Practitioner | Not nominally about teaching — about engineering wisdom transmitted across a generation. The implicit teaching is the point. |
| The Holdovers | 2023 film | 133 min | Inspiring, Dark | Mixed | The long-arc relationship with one student. Not all teaching scales; the unscaled kind is sometimes the most important. |
MODULE 6 — Writing for Learners #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Daniele Procida — What Nobody Tells You About Documentation | PyCon AU 2017+ | 30–45 min | Mind-bending, Technical | Practitioner | The originating Diátaxis talk. Four kinds of docs, four disciplines; conflating them is most engineering writing's failure mode. |
| Larry McEnerney — The Craft of Writing Effectively | UChicago | 1.5 hr | Technical | Practitioner | The single best lecture on writing for readers who don't owe you attention. Watch twice. |
| Steven Pinker — The Sense of Style talks | 2014+ | 45–60 min | Technical | Empirical | Cross-listed from M2; classic style as the antidote to curse-of-knowledge prose. |
| William Zinsser — On Writing Well interviews/readings | archive | 30–60 min | Technical | Practitioner | Clutter is the disease; clear writing is bounded complexity. |
| Verlyn Klinkenborg — Several Short Sentences talks | 2013+ | 30–60 min | Mind-bending | Practitioner | The contrarian counterpoint to Pinker. Hold both in tension. |
| Patrick McKenzie — Kalzumeus / Bits About Money essays | 2012+ | 30–60 min | Technical | Practitioner | The canonical "engineer who wrote his career into being" archive. The essays are the curriculum. |
MODULE 7 — Speaking #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Patrick Winston — How to Speak | MIT | 1 hr | Technical | Practitioner | The canonical lecture on lecturing. Watch annually. |
| Sandi Metz — All the Little Things | RailsConf 2014 | 35 min | Inspiring | Practitioner | The masterclass: one technique taught deeply enough in 35 minutes to change practice. A talk that compounded into a decade-long teaching career. |
| Bret Victor — Inventing on Principle | CUSEC 2012 | 55 min | Mind-bending | Practitioner | The demo as argument. Probably the most influential engineering talk of the 2010s. |
| Rich Hickey — Simple Made Easy | Strange Loop 2011 | 1 hr | Mind-bending | Practitioner | Almost no slides, no demo, pure argument. The philosophical-talk form done right. |
| Gary Bernhardt — Wat | CodeMash 2012 | 4 min | Fun | Practitioner | Four minutes more memorable than most hour-long talks. Study the compression. |
| Damian Conway — Fun with Dead Languages | 2013 | 1 hr | Fun | Practitioner | Master class in pacing, demos, and audience pleasure. |
| Jonathan Blow — Preventing the Collapse of Civilization | 2019 | 72 min | Dark | Practitioner | The deliberately uncomfortable talk. Not all teaching needs to be palatable. |
| Aaron Patterson — RubyConf/RailsConf keynotes | 2010+ | ~45 min each | Fun, Inspiring | Practitioner | Education and entertainment simultaneously — which is part of why they compound. |
| Kelsey Hightower — conference keynotes | 2017+ | ~45 min | Inspiring | Practitioner | The cleanest example of talks that built the career rather than reflecting it. |
| Amy Wibowo — sketch-based talks | 2015+ | 30–45 min | Fun | Practitioner | The visual-first format; a model if your topic has any geometry. |
MODULE 8 — Video #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| 3Blue1Brown — Essence of Calculus ch. 1–2 | YouTube | 30 min | Mind-bending | Practitioner | The high-water mark of animation-first teaching. Watch as a producer, not a consumer. |
| Andrej Karpathy — Let's build GPT from scratch | 2023 | ~2 hr | Technical | Practitioner | A working scientist teaching at the limit of his craft, long-form. |
| Casey Muratori — Handmade Hero (any episode) | YouTube | 1–2 hr | Technical | Practitioner | Decades of cumulative thinking transmitted in real time. Strongly opinionated; worth disagreeing with. |
| Tom Scott — There is no algorithm for truth | 2019 | 19 min | Technical | Practitioner | Solo on-camera, no effects. Study pacing and presence. |
| Fireship — any X in 100 Seconds | YouTube | 100 sec | Fun | Practitioner | The compressed-entertainment model at its purest. |
| Bartosz Milewski — Category Theory lectures | YouTube | hours | Technical | Practitioner | The patient-mathematician lecture model for programmers. |
| Reducible — algorithm visualizations | YouTube | 20–40 min | Mind-bending | Practitioner | The 3Blue1Brown lineage applied to CS topics. |
MODULE 9 — Across the Technical / Non-Technical Divide #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Bartosz Ciechanowski — interactive explanations | ciechanow.ski | 5–8 hr total | Mind-bending | Practitioner | GPS, gears, internal combustion. Read several to internalize what radical patience in exposition looks like. |
| Distill.pub archives | distill.pub | varies | Technical | Mixed | Defunct but archived. The high-water mark for interactive ML explanation. |
| Common Craft — in Plain English explainers | commoncraft.com | 2–3 min each | Fun | Practitioner | The procedural template for explaining technology to everyone. |
| Hannah Fry — BBC science series + public talks | 2018+ | varies | Fun, Inspiring | Mixed | Math-and-CS for general audiences; the technical-to-public bridge done well. |
| Vi Hart — math doodling videos | YouTube | 5–15 min | Fun | Practitioner | Mathematics for people who hated math. A different form again. |
MODULE 10 — Workshops & Curriculum Architecture #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Eric Mazur — Confessions of a Converted Lecturer | (also M1) | 1 hr | Cautionary | Empirical | The case for active over passive instruction, by someone who lived the conversion. |
| Carl Wieman — active-learning lectures | 2015+ | 1 hr | Technical | Empirical | Nobel-laureate physicist on what we actually know about university teaching. The science is brutal to lectures. |
| Bret Victor — Up and Down the Ladder of Abstraction | 2011 | 30–60 min | Mind-bending | Practitioner | Curriculum architecture as system design for learning paths; apply engineering rigor directly. |
| Connie Malamed — eLearning Coach archive | 2015+ | 30–60 min | Technical | Practitioner | Instructional design at curriculum scale — decades of practitioner work engineers can borrow. |
| Salman Khan — TED 2011 + origin-story interviews | 2011+ | 20–90 min | Historical, Inspiring | Practitioner | Calibration: Khan Academy's outcome data is mixed; the curriculum-architecture intuitions remain useful. |
| Ryan Singer — Shape Up talks | 2019+ | 30–60 min | Technical | Practitioner | Shaping bets and cycles — the same shape applies to shaping modules. |
MODULE 11 — Knowledge Products as a Business #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Wes Kao — cohort-based-course talks + essays | wes-kao.com, 2021+ | 30–60 min | Technical | Practitioner | The canonical Maven co-founder voice (she left Maven operations in 2023). Cohort economics chosen deliberately, not because trending. |
| Gagan Biyani — Maven keynotes + interviews | 2021+ | 60–90 min | Technical | Practitioner | Udemy-vs-Maven economics in founder voice. Most cohorts fail because they don't earn the price. |
| Patrick Campbell / Paddle — pricing-research talks | 2017+ | 30–60 min | Mind-bending | Empirical | The empirical pricing-data substrate applied to information products. Watch before you set any price. |
| Patrick McKenzie — Charge More essays | Kalzumeus | 30–60 min | Mind-bending | Practitioner | Underpricing compounds against you for decades — the framing that applies to a 499 course exactly as it does to SaaS. |
| Nathan Barry / Kit — knowledge-product-economics interviews | 2017+ | 45–90 min | Technical | Practitioner | Calibration: vested interest, but the revenue architecture is well-articulated. (ConvertKit rebranded to Kit, 2024.) |
| Pat Flynn — Smart Passive Income, 2010–2017 era only | podcast archive | 45–60 min | Technical | Practitioner | The original is unusually grounded; the modern course-creator cult is downstream of it, and worse. |
| Tiago Forte — BASB content | 2017+ | 30–60 min | Cautionary | Practitioner | Critical lens. Extract the knowledge-product business architecture; refuse the productivity-cult register. |
| Ali Abdaal — creator-economics content | 2021+ | 30–60 min | Cautionary | Practitioner | Critical lens. The funnel mechanics are observable; the influencer overlay is cargo. |
| Indie Hackers — cohort-pivot / shutdown interviews | 2018+ | 45–90 min | Dark | Practitioner | Founders honest about format decisions that went wrong. Required before choosing cohort vs self-paced. |
| Visakan Veerasamy — audience-building threads | online | varies | Mind-bending | Practitioner | The most thoughtful living writer on audience dynamics for non-startup creators. |
MODULE 12 — Ethics of Public Teaching #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Maciej Cegłowski — any talk | idlewords.com | 1 hr each | Mind-bending, Dark | Practitioner | The cleanest living model of an engineer-public-intellectual handling reach honestly. Start with The Moral Economy of Tech. |
| Cory Doctorow — "enshittification" talks | 2023+ | 30–60 min | Dark | Practitioner | How teaching platforms degrade, and what that means for creators who build on them. |
| MOOC completion-rate research | Reich & Ruipérez-Valiente 2019, Science | papers + explainers | Dark | Empirical | The evidence that "free at scale" produces low completion — the failure of optimizing for coverage over outcomes. |
| Forte BASB cohort-drama coverage | 2022–2023, YouTube/threads | varies | Cautionary | Mixed | Even successful cohort courses have publicly documentable failure modes on price tiers and outcome claims. |
| Coded Bias | 2020 documentary | 86 min | Dark, Historical | Mixed | Public-tech communication as both research and pedagogy, with stakes. |
| Ted Chiang — The Truth of Fact, the Truth of Feeling | short story | 1 hr | Mind-bending | Practitioner | What writing does to memory and authority. Tangential; high yield. |
MODULE 13 — The Long Arc #
| Title | Source / Year | Time | Mood | Grade | Why Watch |
|---|---|---|---|---|---|
| Randy Pausch — Last Lecture | CMU 2007 | 76 min | Inspiring, Historical | Practitioner | The source talk. Watch even if you read the book. |
| Rich Hickey — Hammock Driven Development | 2010 | 40 min | Mind-bending | Practitioner | The discipline of thinking before doing. The right energy for a capstone. |
| Tom Scott — Why I'm leaving YouTube | 2023 | 12 min | Cautionary | Practitioner | An honest sustainability check on a decade of solo educational creation. |
| Mr. Holland's Opus | 1995 film | 142 min | Inspiring, Historical | Mixed | Teaching done seriously is a 30-year game; satisfaction metrics diverge from long-term impact. |
| The Class (Entre les Murs) | 2008 film | 128 min | Dark | Practitioner | Teaching is craft that fails publicly; willingness to fail publicly is part of the discipline. |
| Half Nelson | 2006 film | 106 min | Dark, Cautionary | Practitioner | Teaching with integrity inside compromised systems, while your own discipline runs parallel. |
| Code Rush | 2000 documentary | 60 min | Historical | Mixed | Engineering teaching in real time, in extremis, during the Mozilla source release. Free on archive.org. |
| AlphaGo | 2017 documentary | 90 min | Historical, Mind-bending | Mixed | A team teaching itself in public during the match; the post-match interviews are unintentional pedagogy. |
CHANNELS WORTH SUBSCRIBING TO #
| Channel | Why |
|---|---|
| 3Blue1Brown | Glacial cadence, unmatched quality. The visualization bar. |
| Andrej Karpathy | Rare posts; each is a scientist teaching at the bleeding edge. |
| Casey Muratori (Molly Rocket) | Programming-as-craft lectures; worth disagreeing with. |
| Reducible | CS in the 3Blue1Brown lineage. |
| Strange Loop archives | The defunct conference's graveyard of excellent talks. |
| GOTO Conferences | The most consistent engineering-conference channel. |
| UCLA Bjork Lab + AFT (Willingham) | The free empirical-research archive for M1 and M4. |
HOW TO USE THIS TRACK #
-
Less than this list suggests. Two to four hours a week during the curriculum, one after. Production over consumption — the deliverables are the curriculum, not the watching.
-
Match mood to evening. After a hard pricing session, watch Patrick Campbell or read Charge More — not an Ali Abdaal revenue video, which feeds the cargo-cult flinch.
-
The Cautionary entries require the lens, not avoidance. Watch one Forte/Abdaal/Welsh piece a month with the critical lens on; don't chain three in a weekend.
-
Re-watch the high-leverage entries. Metz, Winston, Procida, one Bjork lecture, Inventing on Principle — these deepen on second viewing, especially when you bring a real artifact (a README, a talk draft) to it.
-
Honor the grades. Practitioner experience is not Empirical evidence; Empirical research is not the whole territory. Both are real; they are different; the literacy to know which is which is the curriculum's gift.
-
Don't pair two heavy films in one day. Whiplash deserves The Holdovers afterward, or a long walk.
-
If you're in India: nearly everything here is free YouTube/podcast content that works without a VPN; the films rotate across Prime Video, Netflix, and Mubi India — check justwatch.com/in, since rights move quarterly.
Watching is calibration. The work is somewhere else.
The Craft of Teaching — Community Guide (Public Edition) #
Companion track to the Craft of Teaching Mastery Curriculum (Modules 0–13).
For: working software engineers — including those who write docs, give talks, mentor, or are building a course, newsletter, or video channel on the side.
Pairs with: the Mastery Curriculum + CRAFT_OF_TEACHING_MEDIA_TRACK.md
This is the ambient layer: the writers, voices, communities, and rooms that keep the teaching discipline alive between sessions. Tiered ruthlessly, because the course-creator economy is enormous, the research-backed-or-honestly-marked canon is small, and confusing the two is the most expensive failure mode this guide exists to prevent. The right number of subscriptions is the number you actually open. Five well-read newsletters beat fifty unread ones.
Grades: Empirical (research-backed) / Practitioner (lived operator experience) / Mixed (both, or popular synthesis needing a critical lens). The grade is truth-in-labeling, not a quality ranking.
1. NEWSLETTERS & BLOGS #
Tier 1: Must-Follow (read every issue) #
Load-bearing for the curriculum's sensibility. Deliberately capped at eight.
| Source | Author | Grade | Why |
|---|---|---|---|
| Andy Matuschak — essays + working notes | andymatuschak.org | Practitioner | The most thoughtful contemporary writer on retention engineering and tools for thought. The working notes are themselves a model of public teaching. |
| Cathy Moore — Action Mapping blog | cathy-moore.com | Practitioner | Backwards Design operationalized for workplace learning: consequences not content, deliverables not quizzes. Direct M3 substrate. |
| Wes Kao — essays | wes-kao.com | Practitioner | The cohort-economics canon: outcomes vs completion, when cohorts earn their price. M11 substrate. |
| Patrick McKenzie — Bits About Money + Kalzumeus | bam.kalzumeus.com | Practitioner | The best living technical writer; the model for explaining a complex technical-business system. Also the Charge More pricing canon. |
| The Pragmatic Engineer | Gergely Orosz | Practitioner | Industry-research-grade reporting on engineering organizations. A model of researched long-form for engineers. |
| Dan Luu | danluu.com | Practitioner | Deeply researched, zero design effort, no compromises. Proof that voice is not aesthetics. |
| Tanya Reilly | noidea.dog | Practitioner | The "thing-no-one-talks-about" essay form, perfected. Anchor voice for M5. |
| Julie Dirksen — Usable Learning | usablelearning.com | Practitioner | Instructional design sized for non-academics; translates the cognitive-science evidence into moves an engineer can ship. |
Tier 2: Subscribe; Read Selectively #
| Source | Author | Grade | Why |
|---|---|---|---|
| Irrational Exuberance | Will Larson | Practitioner | Staff-engineering thought; the strategy half of the mentoring frame. |
| Lenny's Newsletter | Lenny Rachitsky | Practitioner | The knowledge-product-economics interviews (Kao, Biyani, Forte) are M11 canon. Start free. |
| Julia Evans | jvns.ca | Practitioner | The model of accessible technical writing — read for form, whatever the topic. |
| Daniele Procida — Diátaxis | diataxis.fr | Practitioner | The canonical documentation framework site (tutorials / how-tos / explanation / reference). Required for M6. |
| Michael Nielsen — Augmenting Long-term Memory | augmentingcognition.com | Practitioner | The engineer-friendly entry to spaced repetition. Free, essential for M4. |
| Patrick Campbell / Paddle research | Paddle (ex-ProfitWell) | Empirical | The most empirical pricing-data archive, applied to information products. (ProfitWell acquired by Paddle, 2022.) |
| Hillel Wayne | hillelwayne.com | Mixed | Empirical software-engineering research translated for practitioners — a model of evidence-honest technical teaching. |
| Eli Bendersky | eli.thegreenplace.net | Practitioner | Long-form technical depth, the opposite of trendy. |
| Gagan Biyani — writings + interviews | various | Practitioner | Maven co-founder voice on cohort economics. |
| Robert Bjork — UCLA Lab archive | bjorklab.psych.ucla.edu | Empirical | The originating desirable-difficulties research; selected papers are foundational for M1. |
| Connie Malamed — eLearning Coach | theelearningcoach.com | Practitioner | The cleanest practitioner library on curriculum-scale instructional design (M10). |
| Tara McMullin — essays | various | Practitioner | Small-business knowledge products in non-cult voice. |
| Refactoring | Luca Rossi | Practitioner | Engineering-management synthesis; useful discovery layer. |
| Pointer | weekly digest | Mixed | Discovery mechanism for engineering blog posts. |
Tier 3: Sample When Relevant #
| Source | Grade | Note |
|---|---|---|
| David Perell — free essays (perell.com) | Practitioner | Critical lens. The writing-online thesis is sound; the cohort funnel is filterable. |
| Justin Welsh archive | Practitioner | Critical lens. Solo-creator mechanics real; "$5M ARR" register is performance. |
| John Hattie — Visible Learning summaries | Mixed | Calibration — effect-size methodology has serious critics; the underlying layer holds. |
| Doug Lemov — Teach Like a Champion blog | Practitioner | K-12-focused; principles transfer with translation work, specific techniques often don't. |
| Pedagogy-research voices on social media (Willingham, Christodoulou, Agarwal) | Mixed | Filter: do they cite primary sources? Agarwal's retrievalpractice.org is the standout. |
| Stratechery, Construction Physics, Astral Codex Ten | Mixed | Models of sustained one-person publications; subscribe only if the topic fits. |
| ATD / eLearning Industry trade press | Mixed | Corporate-L&D register; mostly doesn't transfer. Browse, don't subscribe. |
How to Engage #
-
Reply to issues. Authors read replies; a year of thoughtful reading-and-replying makes you someone they know.
-
Cite their work in yours, liberally, with links. Citation builds your credibility with their audience.
-
Don't pitch. "I'd love to guest post" cold emails fail; "your last post made me think of X — here's mine" sometimes lands.
2. PODCASTS #
Pick three; listen to them; let the rest go.
Tier 1 #
| Podcast | Grade | Why |
|---|---|---|
| Soft Skills Engineering | Practitioner | The most useful listen on the human side of an engineering career; superbly calibrated hosts. |
| CoRecursive (Adam Gordon Bell) | Practitioner | Genuinely curious host getting unusually thoughtful answers. Underrated. |
| The Changelog | Practitioner | The flagship open-source interview podcast; depth over breadth. |
| Lenny's Podcast — knowledge-product episodes | Practitioner | Kao / Biyani / creator-economy episodes are the M11 listening canon. Search by guest. |
| Indie Hackers | Practitioner | The knowledge-product-builder interview library, including the honest cohort-pivot failures. |
Tier 2: Sample and Decide #
-
The Pragmatic Engineer Podcast — companion to the newsletter, same quality.
-
The Bootstrapped Founder (Arvid Kahl) — "sell to your audience first" applied to courses.
-
Build Your SaaS (Justin Jackson) — indie-founder-with-day-job reality, applied to knowledge products.
-
Smart Passive Income — 2010–2017 episodes only; the original is grounded, the modern genre isn't.
-
Andy Matuschak interview appearances (Lex Fridman, Dwarkesh) — search by guest, not feed.
-
Oxide and Friends; Signals & Threads — systems-engineering depth; teaching-by-conversation models.
-
The Knowledge Project — selected learning-science episodes; search rather than subscribe.
How to Engage #
-
Take notes on episodes that move you — podcast notes are where blog drafts come from.
-
Don't listen at 2x. The compression destroys the reflection time the medium provides. If you lack the time, read the transcript.
3. COMMUNITIES #
The hardest tier — communities drift into echo chambers, dramaland, or graveyards. The good ones are gold.
| Community | What | Note |
|---|---|---|
| Write the Docs (writethedocs.org) | Technical-writing community: conferences, Slack, guides | The richest technical-writing community on the public internet. Required for M6. |
| Hacker News | The hub of engineer attention | A distribution channel and calibration tool, not a community. Skim the front page; skip the comments. |
| Lobste.rs | Curated HN alternative | Smaller, higher signal; worth posting work to. |
| Rands Leadership Slack | Engineering-leadership Slack | Free, application required. The most consistently useful management community. |
| Topic-specific Discords | Varies enormously | The good ones are excellent for both learning and teaching. Leave the ones not earning their place. |
| Mastodon / Bluesky engineering circles | Distributed | Lower volume than X, often higher signal, especially systems and security. |
| Maven cohort alumni groups | Paid via course | Quality varies by course; evaluate per cohort. |
How to Engage #
-
Lurk first — two weeks before posting. The reputational cost of misfiring on a first post is real.
-
Help before asking. Answer three questions before you ask one. Answering small questions in public is itself low-stakes teaching practice.
-
Leave gracefully when you outgrow. Periodic cull; nothing personal.
4. COGNITIVE-SCIENCE RESEARCH RESOURCES #
The empirical substrate for M1 and M4, in research-community voice.
| Source | Grade | Why |
|---|---|---|
| Pooja Agarwal — retrievalpractice.org | Empirical | A working cognitive scientist's free retrieval-practice library; unusually well-organized for non-academics. |
| Pashler et al. 2008 — Learning Styles: Concepts and Evidence | Empirical | The paper that closed the learning-styles debate. Free PDF; required for M1. |
| Roediger & Karpicke 2006/2008 — retrieval-practice papers | Empirical | The peer-reviewed substrate under Make It Stick. |
| UCLA Bjork Learning and Forgetting Lab | Empirical | The desirable-difficulties publication archive, publicly accessible. |
| Cognitive Science Society / EARLI proceedings | Empirical | Conference proceedings, publicly available, for depth dives. |
| Hattie Visible Learning database | Mixed | Calibration on effect-size criticism; free summaries first. |
5. KNOWLEDGE-PRODUCT PRICING & BUSINESS VOICES #
The M11 canon. Read before you price anything.
| Source | Grade | Note |
|---|---|---|
| Patrick Campbell / Paddle pricing research | Empirical | The empirical pricing-data source, applied to information products. |
| Patrick McKenzie — Charge More + Kalzumeus pricing essays | Practitioner | Underpricing compounds against you for decades; directly transferable from SaaS to courses. |
| Wes Kao + Gagan Biyani — Maven content | Practitioner | The cohort-economics canon in founder voice. |
| Nathan Barry / Kit archive | Practitioner | Creator-economy infrastructure voice. (ConvertKit → Kit, 2024.) Vested interest; well-articulated architecture. |
| Tara McMullin | Practitioner | The honest small-scale counterweight to the bro-marketing canon. |
| Tom Tunguz | Mixed | SaaS-pricing benchmarks; useful calibration, but venture scale ≠ indie scale. |
| Tiago Forte / Ali Abdaal / Justin Welsh | Practitioner | Critical lens, all three. Observable mechanics under a cult register; extract the former, refuse the latter. |
6. DIÁTAXIS & TECHNICAL-WRITING RESOURCES #
| Source | Grade | Why |
|---|---|---|
| diataxis.fr | Practitioner | The canonical framework site, maintained by its originator; used by Django, Cloudflare, NumPy. |
| Write the Docs guides | Practitioner | Community-maintained documentation guides at scale. |
| Stripe docs (as exemplar) + docs-team writings | Practitioner | Widely regarded as the cleanest technical-writing exemplar in modern SaaS. |
| Google developer-documentation style guide | Practitioner | The working reference for docs prose decisions. |
| MDN writing guidelines | Practitioner | Documentation-architecture reference. |
7. TOOLS (with cost honesty) #
Don't over-tool early: ship the MVP teaching artifact on an existing platform first. Over-engineering the toolchain is itself an avoidance pattern.
| Tool | Cost | Use | Note |
|---|---|---|---|
| Anki | Free (desktop/Android); $25 iOS | Spaced repetition | The canonical open implementation. Required for M4. |
| Obsidian / Logseq | Free | Evergreen notes | Optional; an M4 route, not a requirement. |
| Notion / Coda | Free tier sufficient | Course delivery, learner portals | Ship a basic version first; template-polishing is avoidance. |
| Maven | Revenue share | Cohort courses | Only after M11 decides cohort format is right. |
| Podia / Teachable | $33–199/mo | Self-paced courses | Don't subscribe before shipping a free MVP elsewhere. |
| Kit (ex-ConvertKit) | Free to 10K subs | Email / paid newsletter | Optional until you have something to distribute. |
| Loom / Tella | Free tier sufficient | Async video walkthroughs | Free tier covers most indie use. |
| Discord | Free | Cohort / community space | The default; works worldwide. |
| Circle | $39+/mo | Premium community | Only when a paid-community model is decided. |
8. CONFERENCES #
The fastest way to test your speaking practice — and the most expensive way to learn what the recordings teach for free.
Tier 1: Worth Travel If Submitting #
| Conference | Focus | Note |
|---|---|---|
| Local meetups | Everything | Start here. The CFP is a message to the organizer. The rehearsal before any conference. |
| !!Con (regional editions) | 10-minute joy-and-curiosity talks | The friendliest venue for first-time speakers; inclusive CFP. Ideal first M7 deliverable. |
| RubyConf / RailsConf, PyCon, Devoxx | Language ecosystems | Strong communities, accessible CFPs for first-timers — pick your stack's. |
| GOTO | Software practice | Strong CFP; talks reach wide audiences via the YouTube channel. |
| The Lead Developer | Engineering leadership | Smaller, focused; good for senior/staff-flavored teaching. |
| Write the Docs conferences | Documentation | The M6 community in person. |
Tier 2: Watch the Archives #
Strange Loop (ended 2023; archives are gold) · Papers We Love chapters (teaching-by-explaining-research practice) · ML conference archives (NeurIPS/ICML) if your teaching touches ML.
If you're in India: RubyConf India and the regional meetup circuits (Mumbai, Bangalore, Pune) are the highest-leverage speaking venues by far — ₹5–25K plus minimal travel, versus $4,000+ all-in for a US conference whose talks are free on YouTube three weeks later. Submit locally first; travel only when a specific talk is accepted.
How to Engage #
-
Meetup before conference. Skipping the rehearsal usually fails.
-
CFP rejection is data, not verdict. Most accepted speakers were rejected first; submit to two or three.
-
The hallway track is the conference. Talks are recorded; conversations aren't.
9. IF YOU'RE IN INDIA — additional context #
| Source | Grade | Note |
|---|---|---|
| Sridhar Vembu / Zoho Schools of Learning | Practitioner | The closest-fit "build educational infrastructure inside the company" case study. |
| Aakash Gupta — Product Growth | Practitioner | One of the more data-grounded India-based teaching-on-Substack voices. |
| The Indian EdTech market (Unacademy, Physics Wallah, BYJU'S) | Mixed | Observe as a market, don't emulate by default. Its production values, price points, and conversion mechanics are a different genre from the global cohort market. Deciding which market you're building for is itself a format decision (M10/M11). |
| Maven cohorts from IST | — | Live sessions mostly run 9 PM–1 AM IST. Prefer cohorts that publish recordings; skip the live element when the timezone tax is too high. |
Honest note: there is no India-specific equivalent of the Matuschak/Moore/Kao canon yet. The canon above is US/UK-centric; the translation into your context is your work — and a publishing opportunity.
10. PAID COURSES — honest tradeoffs #
Most high-signal teaching-craft education is free or in books under $50. Paid courses earn a place only when (a) the free layer is exhausted, (b) you specifically need the structured peer cohort, or (c) an employer learning budget pays.
| Course | Honest call |
|---|---|
| Maven cohort-craft courses (Kao et al.) | Closest fit if you've decided on cohort format. Consume the free archive first. |
| Building a Second Brain | Skip; the books at a tenth the price cover most of it. |
| Part-Time YouTuber Academy | Skip; the free content covers the mechanics. |
| Write of Passage | Skip; the free essays carry the thesis without the $4K overhead, and the cohort has drawn sustained critique on outcome claims. |
11. WHAT NOT TO SUBSCRIBE TO #
| Skip | Why |
|---|---|
| Course-creator LinkedIn-influencer content | Cargo cult on a thin layer of signal. The named Tier 1–2 voices are the strongest 5%; the rest is performance-of-expertise. |
| The "$10K cohort solves everything" register | Structurally identical across producers; the cohort is one expensive way to do what books and free essays already imply. |
| K-12-only pedagogy feeds | Different learners, incentives, and time budgets; transfer requires translation the feeds don't do. |
| "AI tutors will replace teachers" doom and counter-doom | Both registers are mostly performance. AI augments specific tasks; the judgment layer (outcomes, assessment, price) is unchanged. |
| "10x developer" / productivity newsletters | Mostly recycled tweets. |
| "Personal brand first" / build-in-public-as-discipline | A tactic inverted into an identity; produces audience without product. |
| Guru-flavored "manifest your course business" content | Performance of confidence as solution. Empirically empty. |
Refusing these inputs is itself an M0 deliverable. If you catch three of them on autoplay the weekend a real teaching artifact is due, close the tab and open a Matuschak essay, a Cathy Moore post, or a Campbell pricing study instead.
How to Use This Guide #
-
Tier 1 is the spine — eight newsletters. Most weeks they produce more signal than you can absorb. The discipline is the small list.
-
Tier 2 is ambient; Tier 3 is a search target. Dip in; don't keep up.
-
Multi-home your own teaching. Engineering discourse has fragmented across X, Mastodon, Bluesky, Discords, and newsletters — there is no town square. Don't invest exclusively in any single platform.
-
The guide does not replace the deliverables. Reading more pedagogy without running the M0 audit, more pricing content without doing the M11 math, more writing advice without shipping the rewrite — that's the avoidance pattern this whole document is warning you about.
The list is not the work. The list is so you can find the work, and the audience that wants the work you'll do.
The Engineer Who Teaches Deliberately #
Reading placement: read after Module 0. Re-read before Module 11, when the pricing-and-format decisions arrive and the stakes of operating your teaching surfaces deliberately become concrete.
What this is: A meta-essay on why most engineers underuse teaching as career and revenue infrastructure despite already operating multiple teaching surfaces by accident — and what it costs them across a 20-year career-and-studio lifecycle.
The Pattern #
Watch any technically competent engineer operate over a decade and one of four things tends to happen with respect to teaching.
The first: never-teach. The engineer who treats teaching as someone else's job. Documentation goes to whoever volunteers; conference talks go to whoever wants the visibility; mentoring is for managers; blog posts are for influencers. The engineer ships code, ships well, and reaches year ten with no teaching surface area beyond the occasional internal Slack message answering a junior's question. The compounding curve never starts because the surface never exists. This is the most common pattern in engineering, and it produces a perfectly respectable career trajectory that ends, predictably, at senior-engineer or staff-engineer-at-one-company, with no transferable authority. Asked at year fifteen why teaching never happened, the engineer says I'd rather just code, which is true and was the correct sentence at year three and was a strategic error by year seven.
The second: accidental-teach. The engineer with a library at 20,000 downloads whose docs explain how to instrument production errors. The engineer with a couple of blog posts that did better than expected. The engineer who occasionally answers Stack Overflow and discovers, three years later, that the answers have 50,000 cumulative views. Teaching surface area exists. It compounds, somewhat. Recruiters reach out occasionally; the library produces consulting referrals occasionally; the blog post that did well produces inbound for two years. None of this was directed; it accumulated as a byproduct of doing real engineering work in public. The compounding is real and undirected. The engineer at year ten has more career capital than the never-teach engineer and dramatically less than they would have had if any of the surface had been operated deliberately. This is, statistically, the second-most-common pattern.
The third: performative-teach. The LinkedIn cargo cult. The hashtag-team-building content. The "I'm hiring" posts that generate engagement and no hires. The course-creator pattern that copies Justin Welsh's hooks without Welsh's underlying competence. The substack that posts twice a week and produces no actual reader retention. Teaching-as-personal-branding without learning outcomes. The engineer accumulates followers and produces approximately zero engineers who are better at engineering after consuming the content. This pattern compounds negatively over a decade because the audience eventually notices the substance gap. The engineers who follow at year one stop following at year four; the recruiters who reached out at year two stop reaching out at year five; the consulting rate that should have risen to authority-level instead stagnates because the authority signal turns out to be hollow. Many engineer-influencers in 2026 are inside this pattern and do not yet know they are.
The fourth pattern is the rarest, and is what this curriculum is for: the engineer who teaches deliberately. Watches each teaching surface as a system with inputs, outputs, and a compounding curve. Operates the library docs as a teaching artifact, not as a record of what changed. Operates the conference talk as career infrastructure, not as a vanity slot. Operates the blog as a discovery layer that produces recruiter inbound for two years per quality post. Operates the course or curriculum as a knowledge product priced at the value the customer derives. Watches career and revenue compound across a decade. Reaches year fifteen with transferable authority, multiple revenue streams, hiring access from former mentees who are now hiring managers, and consulting rates two-to-five times the never-teach engineer's. The work is learnable. The work is engineering work, applied to learner cognition and audience economics. The work is what the rest of this curriculum trains.
This essay is about why so few engineers reach the fourth pattern, and what it costs the ones who don't.
What's Actually Going On #
The technical capacity is not the problem. An engineer who has architected a multi-tenant web application, debugged a production incident at 3 AM, and reasoned about cache invalidation across a distributed system has, demonstrably, the cognitive equipment to model how learners learn and how audiences pay. The reasoning is genuinely simpler than the work the same engineer does on a Tuesday morning. The CAP theorem is harder than designing a course module.
The barrier is cultural, and it shows up in specific patterns inside the engineering subculture.
"Teaching is for academics." A persistent piece of cultural mythology in engineering communities is that pedagogy is what credentialed teachers do at universities. The engineer reads about Backwards Design or retrieval practice, recognizes that the language is academic, and concludes that the discipline therefore does not apply to a working engineer who writes the README. This is empirically wrong. Backwards Design is API-first design. Retrieval practice is the test pattern. Spaced repetition is scheduled cache refresh. The academic register is a register, not the substance. The substance transfers cleanly to engineering work the moment the register is translated. The engineer who refuses to translate is refusing the most accessible cognitive-science evidence base available, on the grounds that it sounds like school.
"I'd rather just code." The engineer's default. Coding is comfortable; teaching feels slow. A function that compiles is observable in seconds; a course module that teaches is observable over weeks. The build cycle is fast; the teaching cycle is long. The "I'd rather just code" instinct routes around the slowness by skipping the teaching, which is the same as skipping the only step that would have converted the engineering work into compounding career and revenue value beyond the day-job paycheck. The code ships. The compensation arrives. The compensation is what it is, and stays what it is, because no teaching surface exists to leverage the engineering work into the next step. The never-teach engineer at year ten is paid the market rate for senior-engineer-with-no-public-surface, which is significantly less than the market rate for senior-engineer-known-for-X.
"The docs explain it." The engineer's specific failure mode in writing. Documentation as record-keeping rather than as deliberate skill transfer. The README explains what the library does; it does not explain what to do, why, and how to know it worked. The release note explains what changed; it does not explain why the change matters for the engineer using the library in production. The engineer believes the writing is adequate because it covers the facts. Adequate writing is not teaching. Teaching writing is engineered for the reader's cognitive load, sequenced for working-memory capacity, designed to produce action — and most engineering writing does none of this because most engineers have never been told that any of this is engineering work too.
"I shouldn't charge for what I learned for free." The pricing flinch on knowledge products. The engineer who learned their stack from free blog posts feels morally allergic to charging 9 a month. Same shape, same cost.
"The course-creator industry is gross." Partly true. Justin Welsh's "$5M solo creator" content is partly substantive and partly cargo-cult. Tiago Forte's "Building a Second Brain" is partly useful and partly productivity-cult. Ali Abdaal's YouTube empire is partly about content quality and partly about the YouTube algorithm. The substance and the cult are interwoven; the engineer who refuses the entire space because the cult is real is also refusing the substance. The discipline is to extract the substance and refuse the cult, not to refuse the entire space. The space contains real economic mechanics: knowledge products at the right scale and the right price are a credible revenue channel. The cult content insists this is easy and obvious; it is neither. The substantive content shows the actual mechanics, and the actual mechanics are learnable.
The engineer's specific failure mode: treating teaching as record-keeping. When a feature ships, the engineer's instinct is to update the README to reflect the new state. When a release goes out, the engineer's instinct is to write a changelog entry that lists what changed. When a learner asks how to do X, the engineer's instinct is to point at the docs. Each of these is a record-keeping move. The actual teaching moves — engineer for retention, sequence for cognitive load, design for the reader's working memory, build feedback loops that tell you whether the teaching worked — are the moves engineers default away from because they are not record-shaped. The teaching situations that route through these moves are, in practice, the situations where engineers underdeliver and never know they are underdelivering, because the metric they look at (the docs are accurate) is not the metric that matters (the reader can do the thing).
The Indian-engineer additions. For engineers teaching from and into India (treated at length in CRAFT_OF_TEACHING_FOR_INDIA.md), the cultural barriers stack with additional layers. The "free YouTube content saturates the market" assumption — the belief that because Indian YouTube has thousands of free tutorials on every stack, there is no demand for paid teaching. This is empirically wrong. The free content is mostly low-quality; the paid content at the right quality and right segment has stronger demand than the free content at scale, because quality teaching is rarer than the noise suggests. Indian engineer-founders consistently underestimate this and consequently underprice into the same market the American course creators charge 1,499 in. The INR-vs-USD pricing flinch on knowledge products — I'll charge ₹999 for the Indian audience and <span class="katex-inline" data-formula="99 for the international audience, where the Indian audience is correct for some segments and the">99 is the same flinch that produces $9-a-month SaaS pricing. The "course-creator industry is gross" reaction stacked with the additional cultural layer that public visibility for teaching feels like self-promotion, which is among the most powerful flinches in the cultural stack alongside the salary anchoring. The reframe is the same reframe in both cases: visibility for teaching that produces real learning outcomes is not self-promotion; it is doing the work in public.
These patterns persist not because engineers can't do the teaching-economics math, but because the cultural inputs to the math are uncomfortable to confront. I do not actually know if my docs teach. I do not actually know what my course is worth. I do not actually know whether my conference talk would land. I do not actually know whether I am an authority or whether I just feel like one because I have downloads. The discomfort is the obstacle. Once it is named, the math is the easy part.
Why Engineers Are Uniquely Positioned to Teach #
Here is the move that makes everything afterward easier.
Teaching skill is engineering reliability applied to learner cognition and audience economics.
This is not a metaphor. The substrate is identical.
Backwards Design is API-first design for teaching. You specify what the learner should be able to do (the contract); you specify the evidence that would confirm they can do it (the test); you specify the assessment that produces the evidence (the integration test); you build the minimum content scaffolding that prepares them to pass (the implementation). Forward-designed teaching — the engineer's default of here is what I know, let me write it down — is the equivalent of building a database first and hoping the API emerges. It usually doesn't. Engineers who have architected from contract backward to data model already have the cognitive shape of Backwards Design; the work is to apply the shape to teaching.
Cognitive science of learning is production observability for the learner's brain. Retrieval practice is did the lesson actually persist in working memory? — a read query against the learner's mental cache. Spaced repetition is is the working-memory write being consolidated to long-term storage? — scheduled refreshes against the Ebbinghaus forgetting curve, which has the same shape as cache TTL. Interleaving is the discipline of varied input — the equivalent of fuzzing the learner's emerging mental model so it generalizes rather than memorizes. The cognitive-science evidence base from Brown, Roediger, and McDaniel (Make It Stick, 2014) is solidly empirical and mostly ignored by practitioners, the same way distributed-systems literature is solidly empirical and mostly ignored by application developers. Engineers who can read distributed-systems papers can read cognitive-science papers; the substrate is similar; the discipline is to read with intent.
Retention engineering is cache invalidation. The Ebbinghaus forgetting curve specifies the cache TTL: the learner forgets roughly 50–80 percent of new content within 24 hours unless retrieval practice intervenes. Spaced repetition is scheduled cache refresh at the optimal intervals (Wozniak's SuperMemo / Anki implementations). Retrieval practice is the read that confirms the cache is warm. Engineered teaching builds these into the design; un-engineered teaching offloads retention to the learner ("review this on your own time") and consequently produces low retention. The engineer who designs cache strategies for production systems can absolutely design retention strategies for learner brains; the move is to apply the same engineering rigor to the cognition layer.
Assessment is integration testing for the learning. If the assessment is a quiz, you've shipped a unit-test-only project to production — you know the individual functions work, you do not know the system works. If the assessment is a deliverable that demonstrates the learner can do the thing in real conditions, you've shipped end-to-end tests that confirm the system works. The empirical evidence on this is brutal: quizzes are weak signals of real-world capability; deliverables are stronger signals. Most courses default to quizzes because they are easy to grade; the engineer with integrity refuses the easy grading and designs for actual capability.
Curriculum architecture is system design for learning paths. Modules are services. Dependencies are call graphs. Checkpoints are SLOs. Time estimates are capacity planning. Most knowledge products fail at this level even when individual lessons are good — the path from lesson 1 to lesson N does not actually produce a competent practitioner because the dependency graph is wrong, the prerequisite documentation is missing, the time estimates are sandbagged. Engineers who have designed distributed systems with real constraints have already done this shape of work; the discipline is to apply it to the curriculum layer.
Pricing knowledge products is admission control for the audience-relationship. Below a price floor, the learner does not value the content and does not ship the deliverables — same shape as a rate limiter that lets through too much traffic and consequently degrades service quality for everyone. Above a ceiling, conversion drops below sustainable. The skill is finding the band, not the single price. Engineers who have implemented rate limiters know exactly this shape of decision.
Format selection is capacity planning under real constraints. Live cohorts are high-touch, high-cost, high-pricing-power. Self-paced is low-touch, low-cost, low-pricing-power. Hybrid is the realistic middle. The decision is constraint-driven: your time, your timezone, your audience, your subject matter. The decision is the same shape as choosing among synchronous and asynchronous architectures for a distributed system; you make the choice based on the actual constraints, not on preference.
The lens is what makes the curriculum unusually accessible to engineers. Most teaching content reads as fluffy because it does not speak the language of someone who has architected real systems. You can. The teaching discipline is engineering discipline applied to learner cognition and audience economics. The math is not harder; the squeamishness is.
The lens has a known limit: the assessment-design work is the place where engineering thinking is partly the obstacle. Engineers default to "build a quiz" because quizzes are deterministic and easy to grade. The empirical reframe is uncomfortable: course-graduate-shipped-real-thing is the success metric, not course-completed-quizzes-passed. The reframe makes the course harder, the completion rate lower, the satisfaction scores worse. It also makes the reputation of the course dramatically better over time, because graduates ship things and recommend the course based on outcomes rather than vibes. The discomfort is the diagnostic that you are doing the right work.
The Two Failure Modes #
Most engineers who do attempt teaching collapse into one of two failure modes. Both are partly true, mostly wrong, and the curriculum is built to refuse both.
The academic-pedagogy register. Reads Wiggins & McTighe at full depth, internalizes the K-12 instructional-design canon, attempts to apply Bloom's taxonomy and rubrics-derived-from-state-standards to a web-framework course. Concludes that to do teaching correctly, you need an instructional designer, formal validation, peer review, university-level rigor — none of which is operationally available to a working engineer writing a course in evenings between the day job and family time. The frameworks are not wrong inside their target configuration. The frameworks are wrong for you because you are not inside that configuration. The academic-pedagogy register, applied to working-engineer reality, produces theater — instructional-design documents written for an audience that does not exist, learning-objective taxonomies that map to nothing the learner will actually do, assessment rubrics written for credentialing rather than for capability. The work looks like teaching; the output is bureaucracy. Most engineers who try this give up at week three because the overhead is unsustainable.
The academic-pedagogy register is partly right about something real: structured pedagogy beats unstructured teaching, and the academic canon contains the structure. The academic-pedagogy register is wrong about almost everything else, including which of the structures actually apply at your scale.
The course-creator-cult register. Reads no academic content, dismisses the canon as bureaucracy, models off Justin Welsh / Tiago Forte / Ali Abdaal, builds the course as a personal-branding exercise, ships, observes the result, calls early traction "social proof," doubles down on the personal brand. Sometimes this works at the level of revenue — when the engineer happens to have a real audience and a real product underneath, the cult-flavored marketing produces real income for a year or two. The cult register is partly right that excessive process kills speed.
The cult register is wrong about almost everything else. It produces engineers who ship courses that get bought and not finished. It produces the audience-quality decay where the followers who arrived for substance leave when the substance turns out to be thin and only the hype-followers stay. It produces the learning-outcome failure mode, because no pedagogy was ever read and the course consequently teaches engagement-with-the-creator rather than capability-in-the-subject. The cult register is the failure mode that produces the "$5M solo creator" claims that turn out, on inspection, to be revenue-mostly-from-cohort-driven-FOMO and not sustained value delivery.
The honest middle is what the curriculum trains. Brown / Roediger / McDaniel evidence base + Wiggins & McTighe Backwards Design discipline + Wes Kao cohort-economics math + April Dunford positioning + patio11 essay-as-business framing + the pricing math from this curriculum's M11. The substantive parts of the cognitive-science canon, the substantive parts of the cohort-economics canon, the substantive parts of the writing-online-compounds canon, refused at the cult-content boundary in each. Not academic theater; pedagogy with engineer-economics. Not creator-cult engagement-farming; teaching that produces real capability priced at real value. Not pure-academic register; not pure-cult register. The honest middle, which is harder than either pure position because it requires sustained calibration across years.
The honest middle is the discipline of choosing which frameworks apply at your scale, applying them with intent, and refusing both the bureaucratic-overhead failure mode and the cargo-cult failure mode.
This is the work.
What This Costs You, Specifically #
This section is for you — the engineer with teaching surfaces already operating accidentally. The worked configuration below is common among senior engineers who build in public: an open-source library with real adoption, a course platform or content site, a personal curriculum collection, a side teaching tool, a blog. Substitute your own inventory; the audit transfers.
The library with real adoption. Suppose you maintain an open-source library at 20,000+ downloads — sixty releases, a few thousand tests. By surface area alone, it is plausibly the highest-leverage teaching surface in your portfolio. The README and release notes reach more engineers per quarter than any conference talk you could plausibly give. The teaching question for this surface is not do the docs cover the facts (they probably do); the question is do the docs teach the engineer reading them how to think about the problem domain, when to use what, why the design choices were made, what the tradeoffs are. The honest answer for most maintainers is partly. The release notes record what changed. They mostly do not teach. The hours that would convert the release notes from records into teaching artifacts — four to six hours per release, applied across the next twenty releases — are hours that would compound into a quality of authority signal that the current state of the docs does not produce. The career and revenue cost of not doing this work over the next five years is not a number anyone can quote precisely; it is a credible fraction of the difference between known engineer with a popular library and recognized authority whose library teaches a generation of engineers how to think about the domain.
The course platform. Suppose your platform holds ~50 courses, ~100 projects, ~400 lessons — the single largest teaching surface in your portfolio by content volume, built organically over years. The pedagogy embedded in it has likely never been audited against the cognitive-science evidence base. The Backwards Design retrofit has not been run on any course. The retention engineering has not been built. The assessment design has not been re-engineered for deliverable-over-quiz. The pricing audit has not produced an anchoring-honest answer. The platform is the surface where a 12-month deliberate-teaching investment would produce the largest single change in your revenue trajectory — and that investment has not been made because the surface is treated as content-platform-that-grew rather than as the largest knowledge product you own.
The personal curriculum collection. Suppose you have built a large personal curriculum collection — structured guides, reading paths, module maps you wrote for your own mastery. The collection is itself a teaching product, whether or not it is ever published externally. The honest audit, treated unsentimentally in TEACHING_FOR_THE_CURRICULUM_AUTHOR.md: most personal curricula state outcomes weakly, almost none have validated assessments, the retention layer does not exist, the format-decision question has not been answered. The collection teaches if you read it; for any other learner, it is unproven. The decision tree on whether and how to publish externally is in that applied-vertical file; the cost of not having that decision tree run is one of the larger open questions in the next 24 months of your teaching strategy.
The side teaching tool. The learning tool, starter kit, or interactive tutorial you built once and never positioned. Same shape as the others: surface area exists, deliberate operation does not, and its strategic position relative to the platform and the collection has never been specified.
The blog at a few hundred followers. The smallest teaching surface and the one with the strongest writing-online-compounds research underneath it. Two-year half-life on a quality engineering post. Five-to-fifteen recruiter inbounds across two years per substantive post. The blog at a few hundred followers and irregular cadence is producing approximately zero of the compounding the same blog at 1-2 substantive posts per quarter would produce. The cost of the irregular cadence over the next five years, in recruiter-inbound terms, is in the dozens; in consulting-rate-increase terms, plausibly in the tens of thousands; in career-optionality terms, larger again, because the irregular cadence is what kept the blog at a few hundred followers instead of at 5,000 across the same time window.
The anchoring math, applied to the knowledge-product layer. The flinch that anchors salaries low anchors knowledge-product prices low — this curriculum's M11 attacks the same root cause that the Negotiation, Money & Wealth, and PM & Discovery curricula attack from their own angles. The math transfers directly: 499 across 100 customers across 5 years per knowledge product is $200,000 of foregone revenue per product. Across a portfolio of 3-5 knowledge products over the next decade, this compounds to seven figures. The math in M11 is run with specifics; the seven-figure number is not hyperbole. It is the standard lifetime-compound-cost shape applied at the knowledge-product price point.
The mission-funding implication. If you have goals bigger than a career — the kind that need funding across decades rather than quarters — knowledge products are a credible second leg of revenue alongside whatever you build and sell. The history of self-funded missions includes speaking-and-teaching as a recurring funding mechanism. Teaching is not orthogonal to goals that size; it is potentially load-bearing for them. The fourth pattern (the engineer who teaches deliberately) is the configuration where teaching surface area becomes mission-funding surface area in the second decade. The cost of staying in pattern two (accidental-teach) is the cost of those goals being underfunded for the lifetime of the work.
The cost compounds invisibly per teaching surface. Catastrophically across a 30-year career.
This is not a moral failing. This is the standard engineer default, applied to a teaching layer that no prior curriculum or certificate in most engineers' trajectories has operationalized. The cure is the same cure for any underinstrumented system: name what is happening; build the model; run the diagnostics; calibrate the responses; iterate.
The cure is the rest of this curriculum.
Closing: The Fourth Pattern #
What it looks like to be the engineer who teaches deliberately.
Not the LinkedIn influencer. Not the academic. Not the never-teach engineer at year ten with no transferable authority. Not the accidental-teach engineer at year ten with a library and a blog and no integrated strategy. Not the performative-teach engineer at year ten with 50,000 followers and no real authority underneath. Not the cert-completer who has the frameworks in memory and has never re-engineered a real teaching surface under real time pressure.
The integrator. The engineer who has built a working model of every teaching surface they operate, who knows the topology of the library docs and the curriculum collection and the blog and the course platform and the side tools, who has classified each by career-compounding signal, revenue-compounding signal, learner-outcome signal, and the gap between current state and deliberate state. Who has decided which surfaces deserve the next year of focused investment and which ones do not. Who has applied the cognitive-science evidence to the highest-leverage one. Who has run the Backwards Design retrofit on the highest-priority course. Who has built the retention layer on the most-used artifact. Who has run the pricing audit and made the anchoring-honest decision. Who has refused the academic-pedagogy register and the course-creator-cult register and lives in the honest middle, which is harder than either pure position because it requires sustained calibration across years.
Goals bigger than a career require this. Goals that size are not solo missions. They happen inside organizations and across decades, funded by capital that has to come from somewhere — and the somewhere, for the engineer-founder, is the studio. The studio is funded by products that sell and knowledge products that sell. Knowledge products that sell are downstream of teaching skill. Everything downstream of revenue is downstream of products and knowledge products that sell. The chain runs through this curriculum.
The next twenty years require this. The career compounding from the conference talks that land, the blog posts that produce inbound, the library docs that establish authority, the internal sessions that make you the team's de facto staff engineer. The revenue compounding from the course platform re-engineered, from the curriculum collection eventually published, from the cohort offering layered on top, from the corporate-training format for B2B. The compounding from the second decade where the revenue mix produces the discretionary capital that goals bigger than a career require to be funded. Every step in that trajectory is a series of teaching decisions: what to write, what to charge, what to retire, when to expand, when to compress. The decisions cumulate. The cumulative is whether the work reaches the revenue that funds the goals or stays in pre-revenue indefinitely.
The cost of not having this curriculum is the cost of the next twenty years of teaching decisions made on intuition rather than discipline. The cost compounds invisibly per surface, per quarter, per year. The cure is the curriculum.
The work is learnable.
The work is engineering work — observability, capacity planning, adversarial input testing, admission control, graceful degradation, applied to learner cognition and audience economics. You have done this work, in different shape, for years already. The shift is to do the same work on the teaching layer of the career you are building.
The naming is the first move. Then the audit. Then the cognitive-science layer. Then the Backwards Design retrofit. Then the retention engineering. Then the assessment redesign. Then the curriculum architecture. Then the pricing audit with the anchoring-honest math. Then the format decision. Then the next quarter's repetition of the cadence.
Teach deliberately.
Run it.
Companion essay to the full Craft of Teaching curriculum. The integrator-archetype-applied-to-teaching is the curriculum's central frame. The work was always engineering work. The work was always there.