@rauchg: Working on a new little project. The ππ΄π°π³πΌπ΄ is fully written by hand, because it's for human consumption. The docβ¦
Summary
Guillermo Rauch (rauchg) teases a new small project, arguing that READMEs and blogs should be written by humans for human storytelling, while internal documentation can be written in "AI English" for agents to consume.
View Cached Full Text
Cached at: 10/04/26, 11:20 PM
Working on a new little project. The ππ΄π°π³πΌπ΄ is fully written by hand, because itβs for human consumption. The documentation internals are AI English, because theyβre for agents.
This little rule of thumb can make the world better. Blogs, tweets, READMEs: human communication. Itβs not even about βem dashesβ or lack thereof. Itβs that itβs the story-telling moment where you want to connect with other humans through their words.
Similar Articles
Internal Documentation: Written for humans, agents, or both?
The article discusses whether internal documentation should be written for human readability or optimized for AI agent efficiency, exploring trade-offs and advocating for context-specific formatting.
@rauchg: The filesystem is beautiful. Want your http://eve.dev agent to have GitHub powers? Define πππππ/ππππππ.ππ β¦
Vercel's Guillermo Rauch announces Eve, a framework for building durable AI agents with GitHub integration, featuring sandboxing, human-in-the-loop, and open-source self-hosting.
A modest proposal: Reformat everything to make documents more palatable to AI (5 minute read)
The LF AI & Data Foundation has formed a working group to develop DocLang, an AI-friendly document format backed by IBM, NVIDIA, Red Hat, ABBYY, HumanSignal, and Forgis, aiming to solve the problem of existing formats like PDF and HTML being ill-suited for AI parsing.
@rauchg: I love that @shadcn has managed to build the best UI infrastructure for agents and for humans. It's so so satisfying toβ¦
Guillermo Rauch praises shadcn's new typeset configurator, shadcn/typeset, which provides UI infrastructure for rendering styled markdown for both agents and humans.
@every: AI writing can sound robotic. But it doesnβt have to. Enter: Compound Writing. Most people use AI for writing like a veβ¦
Introduces Compound Writing, a method for using AI in writing through interactive interviews and reviews, with an open-source plugin for Claude Code and Codex featuring reviewer personas.