News for hackers. Stuff that matters.
Re:RAML – RESTful API modeling language by danellis on Thursday September 10, 2015 @05:20PM (#10200635)
It describes how to construct URLs to get from one state to another (e.g. from a base URL to a list of songs, or from the list to an individual song). REST URLs are supposed to be opaque. A RESTful resource should provide links to its related resources for the user agent to navigate.

There's nothing wrong with what the author is trying to do, but it's nothing to do with REST.

Re:RAML – RESTful API modeling language by SeldomSoup on Thursday September 10, 2015 @05:54PM (#10200787)
Oops. That's one detail I missed in all those API tutorials. Thanks.
Re:RAML – RESTful API modeling language by danellis on Thursday September 10, 2015 @06:05PM (#10200852)
The canonical source is Roy Fielding's thesis, in particular chapters 5 and 6.

https://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm