RAML - RESTful API modeling language • Hacker News Board

RAML - RESTful API modeling language

#1

Post by DanI-S » Wed, Oct 02, 2013, 4:20 PM UTC

RAML - RESTful API modeling language
raml.org

Re: RAML - RESTful API modeling language

#2

Post by grogenaut » Wed, Oct 02, 2013, 4:55 PM UTC

It burns the eyes!

Also, put a simple example on the main github page and don't make me go scavenge through 8 links to find out what the thing is.

Re: RAML - RESTful API modeling language

#3

Post by publicfig » Wed, Oct 02, 2013, 5:13 PM UTC

Man, that page is hard to read.

Re: RAML - RESTful API modeling language

#4

Post by louischatriot » Wed, Oct 02, 2013, 5:16 PM UTC

So hard to read. Also, do we really need another modelling language? UML was not enough?

(not saying ML could be used to do that, more like "didn't we learn with UML that these kind of stuff brings pain and no benefits")

Re: RAML - RESTful API modeling language

#5

Post by reedlaw » Wed, Oct 02, 2013, 5:18 PM UTC

publicfig wrote: post #3

Man, that page is hard to read.

Did you try mouse-hovering over paragraphs?

Re: RAML - RESTful API modeling language

#6

Post by rgbrgb » Wed, Oct 02, 2013, 5:24 PM UTC

For those interested in this type of thing, Apiary is building a platform that generates a mock server based on a similar specification language: http://apiary.io/

Re: RAML - RESTful API modeling language

#7

Post by shaunxcode » Wed, Oct 02, 2013, 5:33 PM UTC

reedlaw wrote: post #5

publicfig wrote: post #3

Man, that page is hard to read.

Did you try mouse-hovering over paragraphs?

for me that is what made it difficult, I wanted to see the example in its entirety without having to hover back and forth. The hover "highlight" should be a "oh thats nice" interaction - not a required step for reading.

Re: RAML - RESTful API modeling language

#8

Post by tommmmmm » Wed, Oct 02, 2013, 5:41 PM UTC

shaunxcode wrote: post #7

reedlaw wrote: post #5

Earlier quoted context omitted.

Did you try mouse-hovering over paragraphs?

for me that is what made it difficult, I wanted to see the example in its entirety without having to hover back and forth. The hover "highlight" should be a "oh thats nice" interaction - not a required step for reading.

Agreed, I shouldn't have to constantly move the mouse around just to read the page.

Re: RAML - RESTful API modeling language

#9

Post by rektide » Wed, Oct 02, 2013, 5:42 PM UTC

I for one don't mind the style, don't mind the media experience nor do I mind having one. It's distinct and unique and not hard to read for me, and perhaps even a modicrum of useful- bringing sessions into focus.

It is, however, entirely mobile hostile.

Re: RAML - RESTful API modeling language

#10

Post by taeric » Wed, Oct 02, 2013, 5:44 PM UTC

Is there any reason to think that this will be better than wsdl style descriptions? To wit, WADL tried this, but it seems to have stalled heavily.

I should add I do not find WSDL/WADL as horrible as it could be. There is something nice about being able to generate a client in one of any given number of languages that can hit a service. Sorta sucks when you can't do that with a traditional workflow in REST.