I’m using the API workbench for DataType fragment files and I’m not getting a validation error with this:
#%RAML 1.0 DataType
example: !include ../examples/newProviderSanction.json
type: !include clinicCollection.raml
If present, this sanction is only applicable for the provider at this location.
description: The name of the sanctioning agency
description: The part of the code violated resulting in the sanction
example: Section 1128b8
In particular, is the uses keyword valid for this file fragment? The reason I’m asking is that a colleague is using a different tool and it’s failing validation for them. It’s obvious one of the tools is interpreting the specification incorrectly. It makes sense for us to be using the specification appropriately, so some guidance would be nice. I can then raise a bug for whomever is doing it wrong. I can reorganize the files to resolve it, but I think the specification document is a little light on details about file fragments which is where this confusion is stemming from.