TypeSpec reminds us why OpenAPI exists in the first place

The ergonomocs around crafting APIs and descriptions leaves something to be desired. Writing good typescript feels like it ought be enough to have endpoints well describe themselves & their constraints.