Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

>1. Write a succinct human readable TypeSpec schema >2. Generate an OpenAPI YAML spec from it

Why? Isn't YAML human readable?



Yes, but OpenAPI specs tend to be verbose and hard to navigate. Remembering the exact anchor for the type you defined can be difficult, finding the reference can be harder, and you probably won't get any help from an IDE.

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.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: