SHIP TYPES, NOT DOCS

Summary from the TLDR Dev newsletter

Traditional API documentation is unreliable because it inevitably drifts out of sync with the actual code, causing significant integration challenges for both human developers and AI agents. A better alternative might be to use types directly, which serve as executable and inherently up-to-date contracts. This schema-first approach enforces correctness at compile-time, leading to a much better developer experience, eliminating runtime errors, and enabling AI agents to interact with APIs accurately on the first attempt.