{"action":"created","comment":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/comments/56886394","id":56886394,"diff_hunk":"@@ -422,6 +425,9 @@ Field Name | Type | Description\n <a name=\"operationSchemes\"></a>schemes | [`string`] | The transfer protocol for the operation. Values MUST be from the list: `\"http\"`, `\"https\"`, `\"ws\"`, `\"wss\"`. The value overrides the OpenAPI Object [`schemes`](#oasSchemes) definition. \n <a name=\"operationDeprecated\"></a>deprecated | `boolean` | Declares this operation to be deprecated. Usage of the declared operation should be refrained. Default value is `false`.\n <a name=\"operationSecurity\"></a>security | [[Security Requirement Object](#securityRequirementObject)] | A declaration of which security schemes are applied for this operation. The list of values describes alternative security schemes that can be used (that is, there is a logical OR between the security requirements). This definition overrides any declared top-level [`security`](#oasSecurity). To remove a top-level security declaration, an empty array can be used.\n+<a name=\"operationHost\"></a>host | `string` | The host (name or ip) serving the path. This optional value will override the top-level [host](#oasHost) or path item-level [host](#pathItemHost). if present. This MUST be the host only and does not include the scheme nor sub-paths. It MAY include a port. If the `host` is not included, the host serving the documentation is to be used (including the port). The `host` does not support [path templating](#pathTemplating).","path":"versions/3.0.md","position":14,"original_position":14,"commit_id":"606ecaf1065d855925c41e2c4453c1456c564a30","original_commit_id":"606ecaf1065d855925c41e2c4453c1456c564a30","user":{"login":"whitlockjc","id":98899,"avatar_url":"https://avatars.githubusercontent.com/u/98899?v=3","gravatar_id":"","url":"https://api.github.com/users/whitlockjc","html_url":"https://github.com/whitlockjc","followers_url":"https://api.github.com/users/whitlockjc/followers","following_url":"https://api.github.com/users/whitlockjc/following{/other_user}","gists_url":"https://api.github.com/users/whitlockjc/gists{/gist_id}","starred_url":"https://api.github.com/users/whitlockjc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/whitlockjc/subscriptions","organizations_url":"https://api.github.com/users/whitlockjc/orgs","repos_url":"https://api.github.com/users/whitlockjc/repos","events_url":"https://api.github.com/users/whitlockjc/events{/privacy}","received_events_url":"https://api.github.com/users/whitlockjc/received_events","type":"User","site_admin":false},"body":"Should _\"serving the path\"_ be _\"handling the operation\"_ or something _\"operation\"_ specific?  Might also make sense to mention the order in which things are overridden in the order they are checked.  So instead of _\"the top-level or path item-level\"_ it might make sense to say _\"the path item-level and the top-level\".","created_at":"2016-03-21T19:59:14Z","updated_at":"2016-03-21T19:59:14Z","html_url":"https://github.com/OAI/OpenAPI-Specification/pull/604#discussion_r56886394","pull_request_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/604","_links":{"self":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/comments/56886394"},"html":{"href":"https://github.com/OAI/OpenAPI-Specification/pull/604#discussion_r56886394"},"pull_request":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/604"}}},"pull_request":{"url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/604","id":63424511,"html_url":"https://github.com/OAI/OpenAPI-Specification/pull/604","diff_url":"https://github.com/OAI/OpenAPI-Specification/pull/604.diff","patch_url":"https://github.com/OAI/OpenAPI-Specification/pull/604.patch","issue_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/604","number":604,"state":"open","locked":false,"title":"added changes to include host, basePath, schemes","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":"Please see discussion in #562.  This change documents proposed changes to allow `host`, `basePath`, and `schemes` to optionally be specified in PathItem and Operation objects.","created_at":"2016-03-18T19:26:08Z","updated_at":"2016-03-21T19:59:14Z","closed_at":null,"merged_at":null,"merge_commit_sha":"e6403ee718c7706c7d996c158b1399f4400bbd89","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/604/commits","review_comments_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/604/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/604/comments","statuses_url":"https://api.github.com/repos/OAI/OpenAPI-Specification/statuses/606ecaf1065d855925c41e2c4453c1456c564a30","head":{"label":"OAI:feature/issue-562","ref":"feature/issue-562","sha":"606ecaf1065d855925c41e2c4453c1456c564a30","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-03-21T19:14:54Z","pushed_at":"2016-03-18T19:26:08Z","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":1381,"stargazers_count":3209,"watchers_count":3209,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":961,"mirror_url":null,"open_issues_count":207,"forks":961,"open_issues":207,"watchers":3209,"default_branch":"master"}},"base":{"label":"OAI:OpenAPI.next","ref":"OpenAPI.next","sha":"1b5b90cdc9a06db1633fd87c7061ddef261abef2","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-03-21T19:14:54Z","pushed_at":"2016-03-18T19:26:08Z","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":1381,"stargazers_count":3209,"watchers_count":3209,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":961,"mirror_url":null,"open_issues_count":207,"forks":961,"open_issues":207,"watchers":3209,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/604"},"html":{"href":"https://github.com/OAI/OpenAPI-Specification/pull/604"},"issue":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/604"},"comments":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/issues/604/comments"},"review_comments":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/pulls/604/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/604/commits"},"statuses":{"href":"https://api.github.com/repos/OAI/OpenAPI-Specification/statuses/606ecaf1065d855925c41e2c4453c1456c564a30"}}}}