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.