FAQ

Why are you allowed to define RequestBody and ResponseBody as separated targets for annotations?

Where it is true that both target a single body node, one may want to further restrict an annotation to either a request or response. If anyone wants to address an annotation to both regardless if it's request or response, they still are able to define allowedTargets: [ RequestBody, ResponseBody ].

Are there any breaking changes between RAML 0.8 and 1.0?

Yes, with RAML 1.0 we introduce our first major version and with that there will be breaking changes compared to RAML 0.8 in favour for a more simplified and consistent version. All breaking changes are highlighted here.

In RAML 1.0 'schemas' and 'schema' is deprecated, does that mean RAML 1.0 will remove support for JSON or XML schema?

No, with RAML 1.0 we introduce RAML data types that supports modeling data not only in YAML, but also in JSON/XML. Deprecated only means that the keywords might be removed in a future version. Therefore, it is recommended to use 'types' and 'type' that are fully synonymously to 'schemas' and 'schema' respectively.