{"action":"created","comment":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/comments/81144007","pull_request_review_id":2137046,"id":81144007,"diff_hunk":"@@ -128,8 +128,6 @@ Field Name | Type | Description\n <a name=\"oasVersion\"></a>openapi | `string` | **Required.** Specifies the OpenAPI Specification version being used. It can be used by tooling Specifications and clients to interpret the version. The structure shall be `major`.`minor`.`patch`, where `patch` versions _must_ be compatible with the existing `major`.`minor` tooling. Typically patch versions will be introduced to address errors in the documentation, and tooling should typically be compatible with the corresponding `major`.`minor` (3.0.*). Patch versions will correspond to patches of this document.\n <a name=\"oasInfo\"></a>info | [Info Object](#infoObject) | **Required.** Provides metadata about the API. The metadata can be used by the clients if needed.\n <a name=\"oasHosts\"></a>hosts | [Hosts Object](#hostsObject) | An array of Host objects which provide `scheme`, `host`, `port`, and `basePath` in an associative manner.\n-<a name=\"oasConsumes\"></a>consumes | [`string`] | A list of media types the APIs can consume. This is global to all APIs but can be overridden on specific API calls. Value MUST be as described under [Media Types](#mediaTypes).","path":"versions/3.0.md","position":13,"original_position":13,"commit_id":"650000a84424b3a3c7ae8f375e0774210299daa3","original_commit_id":"650000a84424b3a3c7ae8f375e0774210299daa3","user":{"login":"DavidBiesack","id":545944,"avatar_url":"https://avatars.githubusercontent.com/u/545944?v=3","gravatar_id":"","url":"https://api.github.com/users/DavidBiesack","html_url":"https://github.com/DavidBiesack","followers_url":"https://api.github.com/users/DavidBiesack/followers","following_url":"https://api.github.com/users/DavidBiesack/following{/other_user}","gists_url":"https://api.github.com/users/DavidBiesack/gists{/gist_id}","starred_url":"https://api.github.com/users/DavidBiesack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/DavidBiesack/subscriptions","organizations_url":"https://api.github.com/users/DavidBiesack/orgs","repos_url":"https://api.github.com/users/DavidBiesack/repos","events_url":"https://api.github.com/users/DavidBiesack/events{/privacy}","received_events_url":"https://api.github.com/users/DavidBiesack/received_events","type":"User","site_admin":false},"body":"For incompatible changes to OAS from 2.0 to 3.0, we need a guide (separate from the spec) on how to convert (or interpret). I.e. if `consumes`/`produces` are removed here, how does one transform a 2.0 document to 3.0 and preserve the same API definition? This also applies to removing  `consumes`/`produces` on an operation. It's only slightly clearer there, since the `representations`  exist, but there are still some ambiguities: if produces lists more than one media type, which one is mapped to the 2xx response bodies, and what happens to the others?  Example 2: how are the top level  `consumes`/`produces` merged with the operation  `consumes`/`produces` to yield the same effective `representations` in request and response bodies?","created_at":"2016-09-29T14:05:43Z","updated_at":"2016-09-29T14:05:43Z","html_url":"https://github.com/OAI/OpenAPI-Specification/pull/798#discussion_r81144007","pull_request_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798","_links":{"self":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/comments/81144007"},"html":{"href":"https://github.com/OAI/OpenAPI-Specification/pull/798#discussion_r81144007"},"pull_request":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798"}}},"pull_request":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798","id":87252608,"html_url":"https://github.com/OAI/OpenAPI-Specification/pull/798","diff_url":"https://github.com/OAI/OpenAPI-Specification/pull/798.diff","patch_url":"https://github.com/OAI/OpenAPI-Specification/pull/798.patch","issue_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/798","number":798,"state":"open","locked":false,"title":"updated #761 for naming consistency","user":{"login":"fehguy","id":249413,"avatar_url":"https://avatars.githubusercontent.com/u/249413?v=3","gravatar_id":"","url":"https://api.github.com/users/fehguy","html_url":"https://github.com/fehguy","followers_url":"https://api.github.com/users/fehguy/followers","following_url":"https://api.github.com/users/fehguy/following{/other_user}","gists_url":"https://api.github.com/users/fehguy/gists{/gist_id}","starred_url":"https://api.github.com/users/fehguy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fehguy/subscriptions","organizations_url":"https://api.github.com/users/fehguy/orgs","repos_url":"https://api.github.com/users/fehguy/repos","events_url":"https://api.github.com/users/fehguy/events{/privacy}","received_events_url":"https://api.github.com/users/fehguy/received_events","type":"User","site_admin":false},"body":"This is a follow-up PR for #761, which fixes #721.  The `representations` element has been added, along with support for multiple examples throughout the `schema` object.  In addition, the request body examples from #670 has been added to the PR.\r\n\r\n","created_at":"2016-09-29T06:21:26Z","updated_at":"2016-09-29T14:55:46Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b1f6d11769f40c9bbcfc941990b945742b95289c","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798/commits","review_comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798/comments","review_comment_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/comments{/number}","comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/798/comments","statuses_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/statuses/650000a84424b3a3c7ae8f375e0774210299daa3","head":{"label":"OAI:issue-721-alt","ref":"issue-721-alt","sha":"650000a84424b3a3c7ae8f375e0774210299daa3","user":{"login":"OAI","id":16343502,"avatar_url":"https://avatars.githubusercontent.com/u/16343502?v=3","gravatar_id":"","url":"https://api.github.com/users/OAI","html_url":"https://github.com/OAI","followers_url":"https://api.github.com/users/OAI/followers","following_url":"https://api.github.com/users/OAI/following{/other_user}","gists_url":"https://api.github.com/users/OAI/gists{/gist_id}","starred_url":"https://api.github.com/users/OAI/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/OAI/subscriptions","organizations_url":"https://api.github.com/users/OAI/orgs","repos_url":"https://api.github.com/users/OAI/repos","events_url":"https://api.github.com/users/OAI/events{/privacy}","received_events_url":"https://api.github.com/users/OAI/received_events","type":"Organization","site_admin":false},"repo":{"id":17372733,"name":"OpenAPI-Specification","full_name":"OAI/OpenAPI-Specification","owner":{"login":"OAI","id":16343502,"avatar_url":"https://avatars.githubusercontent.com/u/16343502?v=3","gravatar_id":"","url":"https://api.github.com/users/OAI","html_url":"https://github.com/OAI","followers_url":"https://api.github.com/users/OAI/followers","following_url":"https://api.github.com/users/OAI/following{/other_user}","gists_url":"https://api.github.com/users/OAI/gists{/gist_id}","starred_url":"https://api.github.com/users/OAI/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/OAI/subscriptions","organizations_url":"https://api.github.com/users/OAI/orgs","repos_url":"https://api.github.com/users/OAI/repos","events_url":"https://api.github.com/users/OAI/events{/privacy}","received_events_url":"https://api.github.com/users/OAI/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/OAI/OpenAPI-Specification","description":"The OpenAPI Specification Repository","fork":false,"url":"https://api.github.com/repos/OAI/OpenAPI-Specification","forks_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/forks","keys_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/keys{/key_id}","collaborators_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/teams","hooks_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/hooks","issue_events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/events{/number}","events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/events","assignees_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/assignees{/user}","branches_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/branches{/branch}","tags_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/tags","blobs_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/refs{/sha}","trees_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/trees{/sha}","statuses_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/statuses/{sha}","languages_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/languages","stargazers_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/stargazers","contributors_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/contributors","subscribers_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/subscribers","subscription_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/subscription","commits_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/commits{/sha}","git_commits_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/commits{/sha}","comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/comments{/number}","issue_comment_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/comments{/number}","contents_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/contents/{+path}","compare_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/compare/{base}...{head}","merges_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/merges","archive_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/downloads","issues_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues{/number}","pulls_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls{/number}","milestones_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/milestones{/number}","notifications_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/labels{/name}","releases_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/releases{/id}","deployments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/deployments","created_at":"2014-03-03T16:53:36Z","updated_at":"2016-09-29T08:11:58Z","pushed_at":"2016-09-29T06:21:26Z","git_url":"git://github.com/OAI/OpenAPI-Specification.git","ssh_url":"git@github.com:OAI/OpenAPI-Specification.git","clone_url":"https://github.com/OAI/OpenAPI-Specification.git","svn_url":"https://github.com/OAI/OpenAPI-Specification","homepage":"https://openapis.org","size":1703,"stargazers_count":4612,"watchers_count":4612,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1392,"mirror_url":null,"open_issues_count":251,"forks":1392,"open_issues":251,"watchers":4612,"default_branch":"master"}},"base":{"label":"OAI:OpenAPI.next","ref":"OpenAPI.next","sha":"e67ceb4f16f6455b70a55f13ab8c24e49fc4a126","user":{"login":"OAI","id":16343502,"avatar_url":"https://avatars.githubusercontent.com/u/16343502?v=3","gravatar_id":"","url":"https://api.github.com/users/OAI","html_url":"https://github.com/OAI","followers_url":"https://api.github.com/users/OAI/followers","following_url":"https://api.github.com/users/OAI/following{/other_user}","gists_url":"https://api.github.com/users/OAI/gists{/gist_id}","starred_url":"https://api.github.com/users/OAI/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/OAI/subscriptions","organizations_url":"https://api.github.com/users/OAI/orgs","repos_url":"https://api.github.com/users/OAI/repos","events_url":"https://api.github.com/users/OAI/events{/privacy}","received_events_url":"https://api.github.com/users/OAI/received_events","type":"Organization","site_admin":false},"repo":{"id":17372733,"name":"OpenAPI-Specification","full_name":"OAI/OpenAPI-Specification","owner":{"login":"OAI","id":16343502,"avatar_url":"https://avatars.githubusercontent.com/u/16343502?v=3","gravatar_id":"","url":"https://api.github.com/users/OAI","html_url":"https://github.com/OAI","followers_url":"https://api.github.com/users/OAI/followers","following_url":"https://api.github.com/users/OAI/following{/other_user}","gists_url":"https://api.github.com/users/OAI/gists{/gist_id}","starred_url":"https://api.github.com/users/OAI/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/OAI/subscriptions","organizations_url":"https://api.github.com/users/OAI/orgs","repos_url":"https://api.github.com/users/OAI/repos","events_url":"https://api.github.com/users/OAI/events{/privacy}","received_events_url":"https://api.github.com/users/OAI/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/OAI/OpenAPI-Specification","description":"The OpenAPI Specification Repository","fork":false,"url":"https://api.github.com/repos/OAI/OpenAPI-Specification","forks_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/forks","keys_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/keys{/key_id}","collaborators_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/teams","hooks_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/hooks","issue_events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/events{/number}","events_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/events","assignees_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/assignees{/user}","branches_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/branches{/branch}","tags_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/tags","blobs_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/refs{/sha}","trees_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/trees{/sha}","statuses_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/statuses/{sha}","languages_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/languages","stargazers_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/stargazers","contributors_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/contributors","subscribers_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/subscribers","subscription_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/subscription","commits_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/commits{/sha}","git_commits_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/git/commits{/sha}","comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/comments{/number}","issue_comment_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/comments{/number}","contents_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/contents/{+path}","compare_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/compare/{base}...{head}","merges_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/merges","archive_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/downloads","issues_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues{/number}","pulls_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls{/number}","milestones_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/milestones{/number}","notifications_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/labels{/name}","releases_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/releases{/id}","deployments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/deployments","created_at":"2014-03-03T16:53:36Z","updated_at":"2016-09-29T08:11:58Z","pushed_at":"2016-09-29T06:21:26Z","git_url":"git://github.com/OAI/OpenAPI-Specification.git","ssh_url":"git@github.com:OAI/OpenAPI-Specification.git","clone_url":"https://github.com/OAI/OpenAPI-Specification.git","svn_url":"https://github.com/OAI/OpenAPI-Specification","homepage":"https://openapis.org","size":1703,"stargazers_count":4612,"watchers_count":4612,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1392,"mirror_url":null,"open_issues_count":251,"forks":1392,"open_issues":251,"watchers":4612,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798"},"html":{"href":"https://github.com/OAI/OpenAPI-Specification/pull/798"},"issue":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/798"},"comments":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/798/comments"},"review_comments":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798/comments"},"review_comment":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/798/commits"},"statuses":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/statuses/650000a84424b3a3c7ae8f375e0774210299daa3"}}}}
{"actor":{"display_login":"DavidBiesack"}}