News for hackers. Stuff that matters.
Re:RAML – RESTful API modeling language by rlevy on Thursday September 10, 2015 @05:24PM (#10200653)
RAML is essentially a YAML with a specific schema. Tell your IDE to treat .raml files as .yaml and all the syntax highlighting, etc will work perfect
Re:RAML – RESTful API modeling language by mpdehaan2 on Tuesday September 15, 2015 @03:36PM (#10222690)
Ah, that makes a lot more sense then.

It appeared to have weirdness from the homepage:

  - secured: !include http://remote-host/secured.yml
/songs:

Which is invalid YAML.

It turns out this is probably an unfortunate word-wrap in the page, where a non-wrapping text field would better convey the format.