agent-first is the de facto now
I just finished rebuilding our docs at docs.self.xyz, and the whole thing came from one assumption: every page now gets read twice. Once by a developer, and once by the agent sitting next to them. If
writer.mrmehta.in5 min read
The line that stood out to me was: "every page now gets read twice." That perfectly captures what's changing in developer tooling.
For years, good documentation was about helping humans understand a system. Now it also has to help agents execute against it correctly. The cost of stale docs isn't just developer frustration anymore it's agents confidently generating incorrect implementations at scale.
What's interesting is that this shifts documentation from being a support asset to being part of the product itself. If APIs, SDKs, and MCP endpoints are the interface, then machine-readable docs become part of the runtime context that determines whether integrations succeed or fail.
The challenge now isn't making docs agent-friendly. It's keeping them synchronized with reality as fast as the product evolves. That's where most teams will struggle.