📦 Release first ⏩ Ship faster ⚡

📝 You can't improve an email

I've been moving discussions out of email and into versioned Markdown files. Here's what I'm noticing.

Email has a structural problem: the only options are reply and quote. The original message can never be improved. When someone joins a project later, the context is buried in a thread they weren't on. And every reply adds to everyone's inbox backlog.

A Markdown file in a Git repo works differently. I updated a design doc last week that I first wrote months ago — refined the language, added what we learned since then. Anyone on the team can see and modify the current version. The repo tracks every change.

There are certainly good uses for email and messaging. But I'm treating email as ephemeral coordination now, and putting anything I want to last into something anyone can revise.

Email vs Versioned Doc

Cliff Brake April 13, 2026 #communication #documentation #email #git #markdown #collaboration #writing