I have a couple of questions for the community regarding examples validations in RAML
- Should RAML parsers validate examples?
RAML defines that schemas must be either of, an XSD, a JSON schema, or the name of a top level schema
But there is no restriction for examples, they an be anything, random text, documentation…
- How should a parser infer the type of the example? Since there is no restriction, any inference may be wrong.
- What if the body has not defined a schema, but has an example? ==> Do not validate, should a parser warn users here?
- Is the whole RAML invalid if an example is malformed / does not conform to the schema? Should parsers throw an error or a warning on an invalid example?