Quite true, but the benefit of something like this is the ability for humans and machines to parse in one spot. This can be both a spec and documentation at on

Quite true, but the benefit of something like this is the ability for humans and machines to parse in one spot. This can be both a spec and documentation at once. Client libraries can be generated and services can be stubbed. Personally, I'd love to see something in reverse: traverse an existing restful service and produce a RAML document.