4 ms·
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
by hobofan 9y ago
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.
- thejosh 9y agoMaybe it's because the only APIs I've dealt with are kind of terrible, leads a bad taste in my mouth.
- bjz_ 9y agoI 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...