How it’s built
The Process
01Guides start from real sources
Most start with a video the editor learned from. The transcript is fetched and broken into concepts, prerequisites, misconceptions, exercises, and quotable moments with timestamps. Every guide credits its sources on the page.
02Human in the loop
Nothing publishes directly. Every draft arrives as a pull request; the editor reviews, corrects, and merges. Merging is publishing: the site rebuilds and the guide goes live.
| Stage | What happens | What comes out |
|---|---|---|
| Ingest | A source video or document is fetched and broken into concepts, misconceptions, exercises, and quotable moments | Structured notes + source log |
| Draft | The writing tool reads the whole curriculum, then writes an original guide (or extends an existing one) | MDX draft on a branch |
| Review | The draft arrives as a pull request; the editor reviews, corrects, and merges | Published guide |
| Rebuild | Merging rebuilds the static site, so publishing and merging are the same act | Live page |
03The style book is strict
The Academy keeps one written style book. A machine checks some of its rules on every build and blocks the deploy on any hit; the editor holds the rest in review.
| Rule | Held by |
|---|---|
| No em dash anywhere on the site | Build gate |
| Titles and headings stay under a length cap | Build gate |
| Plain words, and fewer of them | Review |
| Say plainly what a thing is | Review |
| No jargon and no invented words | Review |
| No walls of text; the content in the shape that fits it | Review |
These are a sample. The full book lives in skills and permanent memory rules.
04Learning science, applied
- Useful first. Every guide opens with why it matters to real work and ends with an exercise you can run tonight.
- Checkable objectives. The objective box promises plain actions (estimate, restructure, diagnose).
- Active recall. Overview at the end of each guide.
They apply the standard findings on the testing effect and active recall to a guide format.
05The loop behind every change
Major updates or changes run through the Harness Firmware loop:
Scroll sideways for the whole figure
FAQ · The Process
How are the guides made?
Each guide starts from real sources: a lecture the editor learned from, official docs fetched at writing time, or the editor's own field notes. Notes from several sources are combined into one original piece, and a human editor reviews every draft as a pull request before it publishes.
How long are the guides?
Guides run 5 to 11 minutes each, and the whole catalogue is about 311 minutes of reading. A typical guide is made to fit inside one sitting.
Who checks what gets published?
100% of guides pass through the editor, Ryan D. Allen, before they go live. Nothing publishes directly: every draft is a pull request, review notes are resolved, and merging is publishing.