rauchg: handwrite your READMEs for humans, let AI write docs for agents
nicolascraske · x · 2026-10-05
Vercel founder rauchg shares a simple rule of thumb: the README is written by hand because it's for human consumption, while documentation internals are 'AI English' meant for agents. He extends this to blogs and tweets — human-facing writing matters not because of stylistic tells like em dashes, but because it's the storytelling moment where you connect with other humans through your words.
More from coding & agent
- ComfyUI watermark-removal workflow fixes silent VAE resize inpainting misalignment — TekaiGuy · 2026-10-05
- Claude-built open-source chess sim Scacelith features a pure-code OpenGL 4.6 3D engine — darkcenobyte_1 · 2026-10-05
- Arc UI ships 148 animated React components for shadcn and Next.js — _AustinCalvert_ · 2026-10-05
- Dev builds ask/act terminal commands on Codex CLI so anyone can speak English to Bash — sytelus · 2026-10-05
- Grok takes ~60% of AI agent usage on Coinbase in a week, Claude ~13% — nima_owji · 2026-10-05
- Author releases GrokBot video walkthrough to pair with Lauren Tan interview — Arindam_1729 · 2026-10-05