News for hackers. Stuff that matters.
Re:Ask HN: What are the not-so obvious things to consider wh... by ptman on Sunday November 19, 2017 @03:30AM (#15732897)
Swagger/OpenAPI does that for rest to some extent
Re:Ask HN: What are the not-so obvious things to consider wh... by zkomp on Sunday November 19, 2017 @05:53AM (#15733332)
Just want to add one thing about swagger:

please think through your API if you are to design an API, the tools will not think for you and you can fool yourself instead...

Swagger will not magically solve anything. I have seen and experienced that you can really create nonsensical but pretty and auto documented APIs using swagger in no time.