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

JSON is a different kind of yuck to have to author by hand, especially in the volume an api spec tends to be.


I don't like writing structured formats by hand either - at some point, you either need to, as they say in France, split or get off your seat

Either don't write it by hand, i.e. use a generator for the structured format, as the comments advocate for and article is about.

Or, just say you'll never have a spec.


Yes, so use Jsonnet or generate it from some intermediate representation using some alternative method. What’s the problem?


Why though when I can just generate it from my actual code and not have to maintain two copies of my api spec?


Jsonnet introduces another (flawed) language?




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

Search: