Hi all, I’ve been monitoring this project for a while now, but now i’l starting to actually push it into new projects that i work on.
First of all, my vision for RAML is to also have a server-generator. I come from the Microsoft/.NET world, and my goal is to do Web API code generation. That way i’m going to have a “single source of truth” with regards to the API. I’ll be happy to share the code once it’s anyway near ready.
I took this Jukebox API as a sample for a RAML file (https://github.com/mulesoft/raml-tutorial-200/blob/master/jukebox-api.raml). What i’m missing is a strongly typed return schema. Specifically, there is a collection resource type, and there is a /songs method whose get request returns all songs, but the response only gives an example, instead of stating that an array of songs will be returned. Am I missing something? Is that possible in RAML ?
Perhaps this is only a concern for a non-dynamic (or less-dynamic) language such as C#, but I see no reason not to require/allow all types get a formal name (instead of seeing repetition in enums all over, for example)