APIs: Tipos, no Documentación, es el Futuro

El artículo argumenta que la documentación tradicional de APIs es un punto de fallo, ya que tiende a desincronizarse con el código. Propone una alternativa: "ship types" (enviar tipos) en lugar de documentación. Esto significa definir contratos de API a través de tipos de datos, que son ejecutables y se mantienen sincronizados con el código. Esta práctica no solo mejora la productividad de los desarrolladores, sino que también facilita la integración con agentes de IA, que pueden consumir APIs de manera más eficiente y precisa al tener acceso directo a los tipos. El autor, basándose en su experiencia en Cloudflare, aboga por un enfoque donde el compilador actúa como revisor de la documentación y donde los tipos se convierten en la fuente de verdad, impulsando un ecosistema de desarrollo más robusto y adaptable.