>1. Write a succinct human readable TypeSpec schema
>2. Generate an OpenAPI YAML spec from it
Why? Isn't YAML human readable?
Why? Isn't YAML human readable?
I tend to prefer just writing the yaml, but I can also see why these kinds of tools crop up to mitigate the need to remember all the details.