News for hackers. Stuff that matters.
Re:Swagger is now the OpenAPI Specification by hobofan on Monday October 23, 2017 @02:04PM (#15535400)
I thought I was the only one! As far as I can tell the sentiment regarding Swagger/OpenAPI is generally positive, but I am starting to think that's just because it's an improvement over the status quo of "nothing" for most people.

I personally prefer API Blueprint, but even there is room for improvement.

Re:Swagger is now the OpenAPI Specification by bjz_ on Monday October 23, 2017 @09:06PM (#15538360)
I prefer RAML tbh - using Markdown as the basis of an API specification language is a pretty terrible idea. RAML's syntax is much more structured and pleasant, and the type syntax is far nicer to write than JSON Schema. Alas it seems to have lost the battle of network effects...
Re:Swagger is now the OpenAPI Specification by thejosh on Monday October 23, 2017 @03:02PM (#15535983)
Maybe it's because the only APIs I've dealt with are kind of terrible, leads a bad taste in my mouth.