Swagger schema does not validate with OpenAPI tools

[sschuberth]

I'm new to Swagger / OpenAPI, so please bear with me if I'm doing something wrong, but for me using the OpenAPI Generator Gradle Plugin, the openApiGenerate task throws a bunch of validation errors like:

Execution failed for task ':clearly-defined:openApiGenerate'.
> There were issues with the specification. The option can be disabled via validateSpec (Maven/Gradle) or --skip-validate-spec (CLI).
   | Error count: 98, Warning count: 0
  Errors: 
        -attribute paths.'/notices'(post).requestBody is unexpected
        -attribute paths.'/harvest/{type}/{provider}/{namespace}/{name}/{revision}'. Declared path parameter namespace needs to be defined as a path parameter in path or operation level
        -attribute paths.'/definitions/{type}/{provider}/{namespace}/{name}/{revision}'. Declared path parameter provider needs to be defined as a path parameter in path or operation level
...

[sschuberth]

@jeffmcaffer, any hint about this, as that's currently blocking me from talking ClearlyDefined into use in ORT?

[fossygirl]

@ignacionr Can you please look at this?

[sschuberth]

For reference, also see the errors thrown by the Swagger online editor: https://editor.swagger.io/?url=https://api.clearlydefined.io/schemas/swagger.yaml