Source-First Writing

Source-first writing starts from implementation facts: files, interfaces, constraints, runtime behavior, and tradeoffs.

Why it works

Readers of technical publications need more than a summary. They need to know how the thing behaves, why the implementation took its shape, and where the edge cases live.

Checklist

Start with the real system shape.
Show relevant code or architecture decisions.
Explain tradeoffs in practical language.
Keep the article usable after launch.

article.ts


type Article = {
  title: string
  kind: "blog" | "article" | "reference"
}