مستندات کهنه می‌شوند، کلاینت‌هایی که دستی نوشته شده‌اند خراب می‌شوند و تست‌ها حدس می‌زنند API چه برمی‌گرداند. توصیف OpenAPI یک فایل است که دقیقاً می‌گوید API شما چه چیزهایی ارائه می‌دهد، آن هم به شکلی که هم آدم‌ها بتوانند بخوانند و هم ابزارها.