{"action":"created","comment":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments/34808661","id":34808661,"diff_hunk":"@@ -44,9 +44,9 @@ What constitutes a compatible change and how to change the API are detailed by t\n \n ## API versioning\n \n-Fine-grain resource evolution alone makes it difficult to eliminate fields or restructure resource representations. Therefore, Kubernetes supports multiple API versions, each at a different API path prefix, such as `/api/v1beta3`. These are simply different interfaces to read and/or modify the same underlying resources. In general, all API resources are accessible via all API versions, though there may be some cases in the future where that is not true. \n+To make it easier to eliminate fields or restructure resource representations, Kubernetes supports multiple API versions, each at a different API path prefix, such as `/api/v1beta3`. These are simply different interfaces to read and/or modify the same underlying resources. In general, all API resources are accessible via all API versions, though there may be some cases in the future where that is not true. \n \n-Distinct API versions present more clear, consistent views of system resources and behavior than intermingled, independently evolved resources. They also provide a more straightforward mechanism for controlling access to end-of-lifed and/or experimental APIs.\n+We chose to version at the API level rather than at the resource or field level to ensure that the API presents a clear, consistent view of system resources and behavior, and to enable controlling access to end-of-lied and/or experimental APIs.","path":"docs/api.md","position":8,"original_position":8,"commit_id":"50fa8dbb04aa541475a1baae6e02ce32c947ebf0","original_commit_id":"50fa8dbb04aa541475a1baae6e02ce32c947ebf0","user":{"login":"bgrant0607","id":7725777,"avatar_url":"https://avatars.githubusercontent.com/u/7725777?v=3","gravatar_id":"","url":"https://api.github.com/users/bgrant0607","html_url":"https://github.com/bgrant0607","followers_url":"https://api.github.com/users/bgrant0607/followers","following_url":"https://api.github.com/users/bgrant0607/following{/other_user}","gists_url":"https://api.github.com/users/bgrant0607/gists{/gist_id}","starred_url":"https://api.github.com/users/bgrant0607/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/bgrant0607/subscriptions","organizations_url":"https://api.github.com/users/bgrant0607/orgs","repos_url":"https://api.github.com/users/bgrant0607/repos","events_url":"https://api.github.com/users/bgrant0607/events{/privacy}","received_events_url":"https://api.github.com/users/bgrant0607/received_events","type":"User","site_admin":false},"body":"s/lied/lifed/","created_at":"2015-07-16T16:35:32Z","updated_at":"2015-07-16T16:35:32Z","html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11366#discussion_r34808661","pull_request_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366","_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments/34808661"},"html":{"href":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11366#discussion_r34808661"},"pull_request":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366"}}},"pull_request":{"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366","id":40108215,"html_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11366","diff_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11366.diff","patch_url":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11366.patch","issue_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11366","number":11366,"state":"open","locked":false,"title":"Move docs/services-firewalls.md into docs/user-guide/ and make small","user":{"login":"davidopp","id":8264113,"avatar_url":"https://avatars.githubusercontent.com/u/8264113?v=3","gravatar_id":"","url":"https://api.github.com/users/davidopp","html_url":"https://github.com/davidopp","followers_url":"https://api.github.com/users/davidopp/followers","following_url":"https://api.github.com/users/davidopp/following{/other_user}","gists_url":"https://api.github.com/users/davidopp/gists{/gist_id}","starred_url":"https://api.github.com/users/davidopp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidopp/subscriptions","organizations_url":"https://api.github.com/users/davidopp/orgs","repos_url":"https://api.github.com/users/davidopp/repos","events_url":"https://api.github.com/users/davidopp/events{/privacy}","received_events_url":"https://api.github.com/users/davidopp/received_events","type":"User","site_admin":false},"body":"wording changes to api.md\r\n\r\n@bgrant0607 @thockin \r\n","created_at":"2015-07-16T09:04:35Z","updated_at":"2015-07-16T16:35:32Z","closed_at":null,"merged_at":null,"merge_commit_sha":"ef60172d3bd2c4f6d8a29898230feef52077fbfd","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366/commits","review_comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366/comments","review_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments{/number}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11366/comments","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/50fa8dbb04aa541475a1baae6e02ce32c947ebf0","head":{"label":"davidopp:doc1","ref":"doc1","sha":"50fa8dbb04aa541475a1baae6e02ce32c947ebf0","user":{"login":"davidopp","id":8264113,"avatar_url":"https://avatars.githubusercontent.com/u/8264113?v=3","gravatar_id":"","url":"https://api.github.com/users/davidopp","html_url":"https://github.com/davidopp","followers_url":"https://api.github.com/users/davidopp/followers","following_url":"https://api.github.com/users/davidopp/following{/other_user}","gists_url":"https://api.github.com/users/davidopp/gists{/gist_id}","starred_url":"https://api.github.com/users/davidopp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidopp/subscriptions","organizations_url":"https://api.github.com/users/davidopp/orgs","repos_url":"https://api.github.com/users/davidopp/repos","events_url":"https://api.github.com/users/davidopp/events{/privacy}","received_events_url":"https://api.github.com/users/davidopp/received_events","type":"User","site_admin":false},"repo":{"id":25228292,"name":"kubernetes","full_name":"davidopp/kubernetes","owner":{"login":"davidopp","id":8264113,"avatar_url":"https://avatars.githubusercontent.com/u/8264113?v=3","gravatar_id":"","url":"https://api.github.com/users/davidopp","html_url":"https://github.com/davidopp","followers_url":"https://api.github.com/users/davidopp/followers","following_url":"https://api.github.com/users/davidopp/following{/other_user}","gists_url":"https://api.github.com/users/davidopp/gists{/gist_id}","starred_url":"https://api.github.com/users/davidopp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/davidopp/subscriptions","organizations_url":"https://api.github.com/users/davidopp/orgs","repos_url":"https://api.github.com/users/davidopp/repos","events_url":"https://api.github.com/users/davidopp/events{/privacy}","received_events_url":"https://api.github.com/users/davidopp/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/davidopp/kubernetes","description":"Container Cluster Manager","fork":true,"url":"https://api.github.com/repos/davidopp/kubernetes","forks_url":"https://api.github.com/repos/davidopp/kubernetes/forks","keys_url":"https://api.github.com/repos/davidopp/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/davidopp/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/davidopp/kubernetes/teams","hooks_url":"https://api.github.com/repos/davidopp/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/davidopp/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/davidopp/kubernetes/events","assignees_url":"https://api.github.com/repos/davidopp/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/davidopp/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/davidopp/kubernetes/tags","blobs_url":"https://api.github.com/repos/davidopp/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/davidopp/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/davidopp/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/davidopp/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/davidopp/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/davidopp/kubernetes/languages","stargazers_url":"https://api.github.com/repos/davidopp/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/davidopp/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/davidopp/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/davidopp/kubernetes/subscription","commits_url":"https://api.github.com/repos/davidopp/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/davidopp/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/davidopp/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/davidopp/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/davidopp/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/davidopp/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/davidopp/kubernetes/merges","archive_url":"https://api.github.com/repos/davidopp/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/davidopp/kubernetes/downloads","issues_url":"https://api.github.com/repos/davidopp/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/davidopp/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/davidopp/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/davidopp/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/davidopp/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/davidopp/kubernetes/releases{/id}","created_at":"2014-10-14T21:53:51Z","updated_at":"2015-04-19T21:08:14Z","pushed_at":"2015-07-16T09:26:11Z","git_url":"git://github.com/davidopp/kubernetes.git","ssh_url":"git@github.com:davidopp/kubernetes.git","clone_url":"https://github.com/davidopp/kubernetes.git","svn_url":"https://github.com/davidopp/kubernetes","homepage":null,"size":89658,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"GoogleCloudPlatform:master","ref":"master","sha":"596a8a40d12498b5335140f50753980bfaea4f6b","user":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"repo":{"id":20580498,"name":"kubernetes","full_name":"GoogleCloudPlatform/kubernetes","owner":{"login":"GoogleCloudPlatform","id":2810941,"avatar_url":"https://avatars.githubusercontent.com/u/2810941?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCloudPlatform","html_url":"https://github.com/GoogleCloudPlatform","followers_url":"https://api.github.com/users/GoogleCloudPlatform/followers","following_url":"https://api.github.com/users/GoogleCloudPlatform/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCloudPlatform/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCloudPlatform/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCloudPlatform/subscriptions","organizations_url":"https://api.github.com/users/GoogleCloudPlatform/orgs","repos_url":"https://api.github.com/users/GoogleCloudPlatform/repos","events_url":"https://api.github.com/users/GoogleCloudPlatform/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCloudPlatform/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/GoogleCloudPlatform/kubernetes","description":"Container Cluster Manager from Google","fork":false,"url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes","forks_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/forks","keys_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/teams","hooks_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/events","assignees_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/tags","blobs_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/languages","stargazers_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/subscription","commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/merges","archive_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/downloads","issues_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/releases{/id}","created_at":"2014-06-06T22:56:04Z","updated_at":"2015-07-16T16:28:17Z","pushed_at":"2015-07-16T16:31:10Z","git_url":"git://github.com/GoogleCloudPlatform/kubernetes.git","ssh_url":"git@github.com:GoogleCloudPlatform/kubernetes.git","clone_url":"https://github.com/GoogleCloudPlatform/kubernetes.git","svn_url":"https://github.com/GoogleCloudPlatform/kubernetes","homepage":"http://kubernetes.io","size":318640,"stargazers_count":8943,"watchers_count":8943,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":2030,"mirror_url":null,"open_issues_count":1623,"forks":2030,"open_issues":1623,"watchers":8943,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366"},"html":{"href":"https://github.com/GoogleCloudPlatform/kubernetes/pull/11366"},"issue":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11366"},"comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/issues/11366/comments"},"review_comments":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366/comments"},"review_comment":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/pulls/11366/commits"},"statuses":{"href":"https://api.github.com/repos/GoogleCloudPlatform/kubernetes/statuses/50fa8dbb04aa541475a1baae6e02ce32c947ebf0"}}}}