{"action":"created","issue":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/544","labels_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/544/labels{/name}","comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/544/comments","events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/544/events","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/544","id":127330930,"number":544,"title":"$ref in response example","user":{"login":"paulprogrammer","id":4042273,"avatar_url":"https://avatars.githubusercontent.com/u/4042273?v=3","gravatar_id":"","url":"https://api.github.com/users/paulprogrammer","html_url":"https://github.com/paulprogrammer","followers_url":"https://api.github.com/users/paulprogrammer/followers","following_url":"https://api.github.com/users/paulprogrammer/following{/other_user}","gists_url":"https://api.github.com/users/paulprogrammer/gists{/gist_id}","starred_url":"https://api.github.com/users/paulprogrammer/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/paulprogrammer/subscriptions","organizations_url":"https://api.github.com/users/paulprogrammer/orgs","repos_url":"https://api.github.com/users/paulprogrammer/repos","events_url":"https://api.github.com/users/paulprogrammer/events{/privacy}","received_events_url":"https://api.github.com/users/paulprogrammer/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/labels/OpenAPI.Next%20Proposal","name":"OpenAPI.Next Proposal","color":"207de5"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2016-01-18T23:29:31Z","updated_at":"2016-01-25T14:59:57Z","closed_at":null,"body":"I would like to use `$ref` in the response example in order to break up my specification into more readily manageable chunks.  Examples also benefit from being externalized because they can be easily revisioned, and included verbatim in reference implementations.\r\n\r\ndesired structure:\r\n```yaml\r\n      responses:\r\n        200:\r\n          description: Success\r\n          schema:\r\n            $ref: 'profile-models.yaml#/ProfileSearchResponse'\r\n          examples:\r\n            application/json:\r\n              $ref: 'ProfileExample.yaml#/ProfileSearchResponseExample'\r\n```\r\n\r\nToday, the children of examples are included directly, meaning the example itself using this example is:\r\n\r\n```json\r\n{\r\n  \"$ref\": \"ProfileExample.yaml#/ProfileSearchResponseExample\"\r\n}\r\n```"},"comment":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/comments/174533586","html_url":"https://github.com/OAI/OpenAPI-Specification/issues/544#issuecomment-174533586","issue_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/544","id":174533586,"user":{"login":"crankydillo","id":335662,"avatar_url":"https://avatars.githubusercontent.com/u/335662?v=3","gravatar_id":"","url":"https://api.github.com/users/crankydillo","html_url":"https://github.com/crankydillo","followers_url":"https://api.github.com/users/crankydillo/followers","following_url":"https://api.github.com/users/crankydillo/following{/other_user}","gists_url":"https://api.github.com/users/crankydillo/gists{/gist_id}","starred_url":"https://api.github.com/users/crankydillo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/crankydillo/subscriptions","organizations_url":"https://api.github.com/users/crankydillo/orgs","repos_url":"https://api.github.com/users/crankydillo/repos","events_url":"https://api.github.com/users/crankydillo/events{/privacy}","received_events_url":"https://api.github.com/users/crankydillo/received_events","type":"User","site_admin":false},"created_at":"2016-01-25T14:59:57Z","updated_at":"2016-01-25T14:59:57Z","body":"Hi,\r\n\r\nDoes this same issue exist for the example field within [the schema object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#schemaObject)?  If so, will that be addressed as well?\r\n\r\nBasically, we'd like the option to $ref in examples everywhere an example can be specified.\r\n\r\nThanks!"}}