Fred Drake

I think a specification that addresses this topic would be very welcome, and give API specifications and tool builders a common language. (A better situation that having several similar but...

I find the term "format" and it's description there very confusing. If this is really about specifying the range of the value, then "format" makes little sense, and minimum/maximum should...

@sichvoge Whether that's wrong depends on what "format" really means. It's acceptable to format an integer as a floating-point number in a serialization; every digit right of the decimal will...

For `body: Pokemon[]`, I'd expect B only. jsonlint.com is irrelevant here; both examples are JSON, but only B conforms with `body: Pokemon[]`.

@sichvoge I think the specification is clear. If more examples are required (indicated by questions like this coming up), an informative document can be added. My interpretation is based on...

Not sure how best to deal with an optional request entity, but an omitted entity would no longer be a valid JSON document (or XML), so would not be found...

> I guess this is too technical. People didn't ask themselves if a missing property > is equivalent or not to as null property. They just say that "phone number"...

> But I always keep in mind that RAML is to be written by technical people and intend > to provide tools like documentation for all kind of people, including...

@sichvoge My point is that additional clarification isn't required, since the idiomatic usage @boillodmanuel describes is just that, and someone writing an API specification in RAML will get it right...

This needs to be spelled out in the RAML spec. This can't be left as a tooling issue.