Would you recommend this product?
1 Review5.0/5
Looks like a less expressive form of the API Blueprint format: https://apiblueprint.org/
@timdorr Keep in mind that expressiveness comes at a cost: the more expressive and flexible a standard, the less tooling (testing, documentation, SDK automation, etc) can be built around it. There is no perfect balance, which is why numerous standards (all with different levels of expressiveness) exist. To put it a different way: Take a look at who is behind, say, Blueprint and RAML. Blueprint is Apiary, which is an API design tool. Of course it's more expressive; that's the point of Apiary. RAML is made by Mulesoft, which is an API management company. Of course they want everything more semantic and machine-readable. There's a place for both; it's up to you to decide which fits your personal use-case the best.
Upvote (13)Share
@timdorr @rhabal @allnick on a side note on formats. The Linux Foundation is working with a couple of partners on creating the next generation of Swagger (which is 10X more adopted than everything else, also the oldest) under the OAI https://openapis.org/ (which we support as well - @Mashape we could have created our own format, and we thought about for long time, but decided to support a OSS initiative centered around true neutrality, compared to formats owned by a private business motivated by their own interests). An API description format, should be a commodity, that everybody can contribute & owned by anyone, not a mean to connect your commercial offering.
@sinzone Swagger is 10x more adopted than everything else? I'm interested to know where you got this number because I couldn't find any mainstream vendors using it.
@rdardour - saw your interest on the old version - have you looked into the new V1.0? @gkoberger did you manage to get anything consumer facing built with this in the end? @comptly - were you involved in this version too?
@bentossell we support Swagger currently; we'll support RAML with enough nudging :) Either way, I'm excited that there's a big movement toward semantically documenting APIs. It's going to create a proliferation of awesome API-related tools (including making @readmeio much better), and I'm excited for it.
If only it would generate the API form this :)
@allnick you can πŸ˜„ take a look at Ramses.tech (shameless plug)
After using GraphQL for a few months and deploying it to production I don't see myself using REST any more. How would you compare RAML to GraphQL and when would you recommend RAML over GraphQL?
@luisobo not really apples to apples
@sinzone how are the two different enough to not grant a comparison? I didn't mean to sound harsh with my previous comment, I'm looking for the best option, whether that's RAML, GraphQL or anything else. Just trying to learn a bit from the makers :)
I don't know how I haven't heard of this already. Great share!