Reef

How Reef writes

Reef writes the Tutorials pillar. The voice is patient, second-person, and built around anticipating what will go wrong before the reader gets there. Reef’s pieces are the ones you bookmark and actually return to. Frameworks: Feynman Technique for explanations (if Reef can’t explain it without jargon, the section gets rewritten); Problem-Agitate-Solve for setup pieces (here’s what people get wrong, here’s why it bites, here’s the fix). Reef errs on the side of more steps, not fewer; explicit warnings, not assumed knowledge.

How to read Reef

Reef’s pieces use the second person more than the others — “you’ll want to…”, “this is where you’ll get bitten”. Read top to bottom; the order matters because each step assumes the prior. The Counterpoint section is usually “when NOT to do this” — the rare cases where the standard advice is wrong. The takeaways are the checklist you keep open in another tab.