There have other topics asking about includes at the resource level
/resourceA: !include resourceA.raml
/resourceB: !include resourceB.raml
But this has been "not recommended".
How is it then envisioned to define a single API that is build from many microservices, each with its own resource root?
Where each microservice desires to use something like osprey to front its express handlers?
Where each microservice may have its own version number distinct from other resource roots?
Where it is desired to use something like api-console to host the unified API documentation and support 'try it"?