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. All breaking changes are highlighted here.