{"action":"created","issue":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/556","repository_url":"https://api.github.com/repos/OAI/OpenAPI-Specification","labels_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/556/labels{/name}","comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/556/comments","events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/556/events","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/556","id":132083453,"number":556,"title":"Extra JSON Reference properties ignored - reduces reusability of references","user":{"login":"JimSangwine","id":325261,"avatar_url":"https://avatars1.githubusercontent.com/u/325261?v=3","gravatar_id":"","url":"https://api.github.com/users/JimSangwine","html_url":"https://github.com/JimSangwine","followers_url":"https://api.github.com/users/JimSangwine/followers","following_url":"https://api.github.com/users/JimSangwine/following{/other_user}","gists_url":"https://api.github.com/users/JimSangwine/gists{/gist_id}","starred_url":"https://api.github.com/users/JimSangwine/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JimSangwine/subscriptions","organizations_url":"https://api.github.com/users/JimSangwine/orgs","repos_url":"https://api.github.com/users/JimSangwine/repos","events_url":"https://api.github.com/users/JimSangwine/events{/privacy}","received_events_url":"https://api.github.com/users/JimSangwine/received_events","type":"User","site_admin":false},"labels":[{"id":130907055,"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/labels/OpenAPI.Next%20Proposal","name":"OpenAPI.Next Proposal","color":"207de5","default":false},{"id":329766640,"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/labels/Sub%20Issue","name":"Sub Issue","color":"d4c5f9","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":53,"created_at":"2016-02-08T08:48:34Z","updated_at":"2017-06-14T14:58:14Z","closed_at":null,"body":"Hi everyone.\n\nI feel that the ignoring of extra properties when using JSON References goes against the goal of reusability.\n\nTake this example from a fictional Swagger contract:\n\n```\n{\n    addresses: [\n        \"homeAddress\": {\n            \"description\": \"The premises at which electricity is provided.\",\n            \"$ref\": \"#/definitions/Address\"\n        },\n        \"invoiceAddress\": {\n            \"description\": \"The billing address - must be where the customer's credit card is registered.\",\n            \"$ref\": \"#/definitions/Address\"\n        }\n    ]\n}\n```\n\nThe \"description\" properties help to distinguish between the two uses of the \"Address\" Reference. Of course you could argue that better naming of the \"homeAddress\" and \"invoiceAddress\" properties could achieve this, but we are not always in control of property names in our data models and sometimes you need a more verbose description.\n\nThe Swagger editor (http://editor.swagger.io/#/) is an example of an application that could be improved by removing this limitation.\n\nIs this something that has been raised previously? Please see here for a discussion on the Swagger Google Group: https://groups.google.com/forum/#!topic/swagger-swaggersocket/ewgimdO2cOI\n"},"comment":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/comments/308458374","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/556#issuecomment-308458374","issue_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/556","id":308458374,"user":{"login":"handrews","id":2358015,"avatar_url":"https://avatars1.githubusercontent.com/u/2358015?v=3","gravatar_id":"","url":"https://api.github.com/users/handrews","html_url":"https://github.com/handrews","followers_url":"https://api.github.com/users/handrews/followers","following_url":"https://api.github.com/users/handrews/following{/other_user}","gists_url":"https://api.github.com/users/handrews/gists{/gist_id}","starred_url":"https://api.github.com/users/handrews/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/handrews/subscriptions","organizations_url":"https://api.github.com/users/handrews/orgs","repos_url":"https://api.github.com/users/handrews/repos","events_url":"https://api.github.com/users/handrews/events{/privacy}","received_events_url":"https://api.github.com/users/handrews/received_events","type":"User","site_admin":false},"created_at":"2017-06-14T14:58:14Z","updated_at":"2017-06-14T14:58:14Z","body":"Originally, JSON Reference was a separate specification intended for use independent from JSON Schema.  This general problem is definitely a top priority for draft-07."}}
{"actor":{"display_login":"handrews"}}