a builder's codex
codex · operators · Simon Willison · ins_willison-publish-unhappy

Publish writing while still unhappy with it; the perceived flaws are invisible to readers and the only alternative is a folder of permanent drafts

By Simon Willison · Co-creator of Django; creator of Datasette; prolific open-source developer · 2026-08-06 · essay · Simon Willison on Technical Blogging

Tier B · TL;DR
Publish writing while still unhappy with it; the perceived flaws are invisible to readers and the only alternative is a folder of permanent drafts

Claim

The threshold for publishing should be set at the point of still being actively unhappy with the draft, because your perception of the flaws does not match what readers actually experience.

Mechanism

Authors hold a mental model of the finished version they intended to write. Every gap between that ideal and the actual draft registers as a flaw. Readers have no access to the intended version, so they cannot perceive the gap. What the author experiences as "not yet good enough" is, to the reader, simply the complete piece.

Setting a higher bar produces an accumulation of drafts that approach but never reach the imagined ideal, and then never ship. The work that would have been useful disappears.

Willison states the condition precisely:

"Aim to hit publish while you are still actively unhappy with what you have written, because the only alternative is a huge folder full of drafts and never publishing anything at all."

The mechanism is not that lower standards produce better writing. The mechanism is that the gap between what the author experiences and what the reader experiences is large enough that publishing earlier than feels comfortable still produces useful work, and the alternative (never publishing) produces none.

Conditions

Holds when: the author is a technical practitioner sharing knowledge or patterns from direct experience. The reader values the information more than the prose craft.

Fails when: the work is long-form argument or literary writing where craft is part of the value. A rushed essay with unclear reasoning does not benefit from early publication if the reasoning errors are visible to readers.

Evidence

Willison was interviewed by Cynthia Dunlop for her "Write that blog!" series, published on his blog on August 6, 2026. Willison has published over 4000 blog posts since 2002. The advice is grounded in his own practice over more than two decades of consistent public writing.

The adjacent observation: Willison's prolific output (multiple posts per week across technical topics, short links, and longer essays) is itself evidence that the low-threshold-to-publish approach compounds over time. Individual posts do not need to cover every angle to create a useful, searchable body of work.

Signals

Counter-evidence

The advice applies most cleanly to technical blogs and practitioners sharing direct knowledge. For persuasive writing or arguments that require careful logic, early publication of an unclear argument may spread the confusion rather than correct it. The bar "unhappy but publishable" requires some floor of coherence that Willison does not fully specify.

Cross-references

Open the interactive view → View original source → Markdown source →