[Swagger] attribute definitions.Dummy.externalDocs is unexpected

[maechler]

The swagger online validator is throwing an error on the attribute externalDocs. I have tested this with version 2.0.1 of api-platform/core.

I simply copied the expected value from the following test and put it on a webserver:

test
https://github.com/api-platform/core/blob/master/tests/Swagger/Serializer/DocumentationNormalizerTest.php#L711

produced json
http://www.bit9.ch/apiplatform.json

swagger validator
http://online.swagger.io/validator/debug?url=http://www.bit9.ch/apiplatform.json

{
  "messages": [
    "attribute definitions.Dummy.externalDocs is unexpected",
    "attribute definitions.Dummy_be35824b9d92d1dfc6f78fe086649b8f.externalDocs is unexpected"
  ]
}

The swagger specification seems to allow the attribute externalDocs: http://swagger.io/specification/#schemaObject
Do you know about that error? Is that rather a bug of the swagger online validator?
I have not found anything to that issue so far..

[Simperfit]

It is allowed by the schema and the schema is validated with swagger-cli

I don't know about that error.

Maybe it's not allowed in the definitions anymore ?

[dunglas]

It looks like a bug in the online validator. As you pointed out, externalDocs is explicitly allowed by the spec: http://swagger.io/specification/#schemaObject

It should be reported on the validator bug tracker.

[maechler]

Thanks for having a look at it!

swagger-api/validator-badge#97