An Overlay is –
- meant to add or override a RAML API definition
- Only certain properties can be overlayed, e.g. documentation, annotations
- Properties like resources, methods, parameters, etc, cannot be overlayed
- meant to address problems like localization of documentation, implementation & verification information for the use of automated tools
- the tree of nodes in the merged document is compared with the tree of nodes in the master RAML document after resolving all
!includetags
