{"action":"closed","issue":{"url":"https://api.github.com/repos/zircote/swagger-php/issues/273","labels_url":"https://api.github.com/repos/zircote/swagger-php/issues/273/labels{/name}","comments_url":"https://api.github.com/repos/zircote/swagger-php/issues/273/comments","events_url":"https://api.github.com/repos/zircote/swagger-php/issues/273/events","html_url":"https://github.com/zircote/swagger-php/issues/273","id":126044536,"number":273,"title":"Remove oneOf and other invalid schema properties","user":{"login":"xiehan","id":855115,"avatar_url":"https://avatars.githubusercontent.com/u/855115?v=3","gravatar_id":"","url":"https://api.github.com/users/xiehan","html_url":"https://github.com/xiehan","followers_url":"https://api.github.com/users/xiehan/followers","following_url":"https://api.github.com/users/xiehan/following{/other_user}","gists_url":"https://api.github.com/users/xiehan/gists{/gist_id}","starred_url":"https://api.github.com/users/xiehan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xiehan/subscriptions","organizations_url":"https://api.github.com/users/xiehan/orgs","repos_url":"https://api.github.com/users/xiehan/repos","events_url":"https://api.github.com/users/xiehan/events{/privacy}","received_events_url":"https://api.github.com/users/xiehan/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2016-01-11T21:49:11Z","updated_at":"2016-01-15T09:29:54Z","closed_at":"2016-01-15T09:29:54Z","body":"I was super stoked to discover the `oneOf` property in the Schema definition, since we have a major use case for it in our API, but then I discovered just now that the Swagger 2.0 spec doesn't support it: OAI/OpenAPI-Specification#525\r\n\r\nThe discussion at OAI/OpenAPI-Specification#333 reveals that the list of unsupported properties is:\r\n- id\r\n- $schema\r\n- additionalItems\r\n- definitions\r\n- patternProperties\r\n- dependencies \r\n- anyOf\r\n- oneOf\r\n- not\r\n\r\nRather than confuse others who, like me, might jump on the chance to use this and then find their Swagger docs breaking validation, it would probably be better to remove all unsupported properties from [@SWG\\Schema](https://github.com/zircote/swagger-php/blob/master/src/Annotations/Schema.php)."}}