<yxhuvud>
I kinda dislike swagger because there are some common stuff that it doesn't support. Like nested query parameters. Which are fucking everywhere but the standard can't do it. It means for example that it is incompatible with json:api.
r0bby has joined #crystal-lang
<yxhuvud>
also it reinvented parts of json_schema for no valid reason. Instead of using union types like json schema it invented its own, worse, variant of it. bleh.
<FromGitter>
<j8r> maybe. but, what's the better alternatives out there?
<yxhuvud>
That there ain't any good choice doesn't make the existing choices better, sadly.
johnny101 has quit [Ping timeout: 272 seconds]
Vexatoast has quit [Quit: ZNC Quit]
Stephie has quit [Quit: Fuck this shit, I'm out!]
Stephie has joined #crystal-lang
Stephie has quit [Excess Flood]
Vexatos has joined #crystal-lang
mistergibson has quit [Quit: Leaving]
<raz>
yeh there are some alternatives, but none of them has much adoption i think. re: swagger, yup, what yxhuvud said. it's just a horrible impl of a great (and much needed) idea.
<raz>
the tooling is a mess, the doc generators/viewers are a mess. it should be _easy_ to auto-generate api-docs in about any web-framework even without special annotations
<raz>
but in reality, just finding a swagger-plugin at least *somewhat* works is a nightmare even for the most popular frameworks (rails et al)
<raz>
then try to make it cope with any kind of auth, endpoint versioning, payload/response schemas, generating scoped docs (e.g. partners should see only part of the API), etc. ... brrrrr
<raz>
basically everything that you actually need in the real world doesn't work
<raz>
what i don't really understand is why nobody has created a non-broken version of it. without all the json nonsense
<raz>
just a standardized set of comment-annotations (javadoc style). parse the source-tree. done
<raz>
(but yeh i admit it's a hard problem, and we programmers aren't good at solving our own problems)
<FromGitter>
<j8r> raz: that what I done with gripen, - auto api docs generation ;)