attribute definitions.Dummy.externalDocs is unexpected

[maechler]

The online validator is throwing an error on the attribute externalDocs on an entity definition, although it is explicitly allowed by the spec: http://swagger.io/specification/#schemaObject

I have an online example to show that issue: http://www.bit9.ch/apiplatform.json

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"
  ]
}

I also tested it with the release 1.0.4 locally, having the same result.

[brendo]

I have also encountered this issue. The same schema subsequently passed the swagger-tools validator CLI though.