{"action":"created","comment":{"url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments/49903768","id":49903768,"diff_hunk":"@@ -34,19 +34,36 @@ Documentation for other releases can be found at\n \n # Kubernetes API and Release Versioning\n \n+Reference: [Semantic Versioning](http://semver.org)\n+\n Legend:\n \n-* **Kube X.Y.Z** refers to the version of Kubernetes that is released. This versions all components: apiserver, kubelet, kubectl, etc.  (**X** is the major version, **Y** is the minor version, and **Z** is the patch version.)\n+* **Kube X.Y.Z** refers to the version (tag) of Kubernetes that is released. This versions all components: apiserver, kubelet, kubectl, etc.  (**X** is the major version, **Y** is the minor version, and **Z** is the patch version.)\n * **API vX[betaY]** refers to the version of the HTTP API.\n \n ## Release versioning\n \n ### Minor version scheme and timeline\n \n-* Kube X.Y.0-alpha.W, W > 0: Alpha releases are released roughly every two weeks directly from the master branch. No cherrypick releases. If there is a critical bugfix, a new release from master can be created ahead of schedule.\n-* Kube X.Y.Z-beta.W: When master is feature-complete for Kube X.Y, we will cut the release-X.Y branch 2 weeks prior to the desired X.Y.0 date and cherrypick only PRs essential to X.Y.  This cut will be marked as X.Y.0-beta.0, and master will be revved to X.Y+1.0-alpha.0.  If we're not satisfied with X.Y.0-beta.0, we'll release other beta releases, (X.Y.0-beta.W | W > 0) as necessary.\n-* Kube X.Y.0: Final release, cut from the release-X.Y branch cut two weeks prior.  X.Y.1-beta.0 will be tagged at the same commit on the same branch.  X.Y.0 occur 3 to 4 months after X.Y-1.0.\n-* Kube X.Y.Z, Z > 0: [Patch releases](#patch-releases) are released as we cherrypick commits into the release-X.Y branch, (which is at X.Y.Z-beta.W,) as needed.  X.Y.Z is cut straight from the release-X.Y branch, and X.Y.Z+1-beta.0 is tagged on the same commit.\n+* Kube X.Y.0-alpha.W, W > 0 (Branch: master)\n+  * Alpha releases are released roughly every two weeks directly from the master branch.\n+  * No cherrypick releases. If there is a critical bugfix, a new release from master can be created ahead of schedule.\n+* Kube X.Y.Z-beta.W (Branch: release-X.Y)\n+  * When master is feature-complete for Kube X.Y, we will cut the release-X.Y branch 2 weeks prior to the desired X.Y.0 date and cherrypick only PRs essential to X.Y.\n+  * This cut will be marked as X.Y.0-beta.0, and master will be revved to X.Y+1.0-alpha.0.\n+  * If we're not satisfied with X.Y.0-beta.0, we'll release other beta releases, (X.Y.0-beta.W | W > 0) as necessary.\n+* Kube X.Y.0 (Branch: release-X.Y)\n+  * Final release, cut from the release-X.Y branch cut two weeks prior.\n+  * X.Y.1-beta.0 will be tagged at the same commit on the same branch.\n+  * X.Y.0 occur 3 to 4 months after X.Y-1.0.\n+* Kube X.Y.Z, Z > 0 (Branch: release-X.Y)\n+  * Patch releases are released as we cherrypick commits into the release-X.Y branch, (which is at X.Y.Z-beta.W,) as needed.\n+  * X.Y.Z is cut straight from the release-X.Y branch, and X.Y.Z+1-beta.0 is tagged on the same commit.\n+* Kube X.Y.Z-patch.W, Z > 0 (Branch: release-X.Y.Z)\n+  * Cut release-X.Y.Z branch to hold the isolated patch release\n+  * Tag release-X.Y.Z branch + fixes with X.Y.Z-patch.W\n+  * [Branched patch releases](#branched-patch-releases) are rarely needed but used for emergency/critical fixes to the latest release\n+  * These are special and different in that the latest tag is branched to isolate the emergency/critical fix from all other changes that have landed since the previous tag","path":"docs/design/versioning.md","position":38,"original_position":38,"commit_id":"00acd78b343f204fd2eafc9c66254c35582dee80","original_commit_id":"00acd78b343f204fd2eafc9c66254c35582dee80","user":{"login":"david-mcmahon","id":15622407,"avatar_url":"https://avatars.githubusercontent.com/u/15622407?v=3","gravatar_id":"","url":"https://api.github.com/users/david-mcmahon","html_url":"https://github.com/david-mcmahon","followers_url":"https://api.github.com/users/david-mcmahon/followers","following_url":"https://api.github.com/users/david-mcmahon/following{/other_user}","gists_url":"https://api.github.com/users/david-mcmahon/gists{/gist_id}","starred_url":"https://api.github.com/users/david-mcmahon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/david-mcmahon/subscriptions","organizations_url":"https://api.github.com/users/david-mcmahon/orgs","repos_url":"https://api.github.com/users/david-mcmahon/repos","events_url":"https://api.github.com/users/david-mcmahon/events{/privacy}","received_events_url":"https://api.github.com/users/david-mcmahon/received_events","type":"User","site_admin":false},"body":"Done.","created_at":"2016-01-15T20:53:10Z","updated_at":"2016-01-15T20:53:10Z","html_url":"https://github.com/kubernetes/kubernetes/pull/19424#discussion_r49903768","pull_request_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424","_links":{"self":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments/49903768"},"html":{"href":"https://github.com/kubernetes/kubernetes/pull/19424#discussion_r49903768"},"pull_request":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424"}}},"pull_request":{"url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424","id":55495456,"html_url":"https://github.com/kubernetes/kubernetes/pull/19424","diff_url":"https://github.com/kubernetes/kubernetes/pull/19424.diff","patch_url":"https://github.com/kubernetes/kubernetes/pull/19424.patch","issue_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/19424","number":19424,"state":"open","locked":false,"title":"Expand explanation of patch version vs. patch release.","user":{"login":"david-mcmahon","id":15622407,"avatar_url":"https://avatars.githubusercontent.com/u/15622407?v=3","gravatar_id":"","url":"https://api.github.com/users/david-mcmahon","html_url":"https://github.com/david-mcmahon","followers_url":"https://api.github.com/users/david-mcmahon/followers","following_url":"https://api.github.com/users/david-mcmahon/following{/other_user}","gists_url":"https://api.github.com/users/david-mcmahon/gists{/gist_id}","starred_url":"https://api.github.com/users/david-mcmahon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/david-mcmahon/subscriptions","organizations_url":"https://api.github.com/users/david-mcmahon/orgs","repos_url":"https://api.github.com/users/david-mcmahon/repos","events_url":"https://api.github.com/users/david-mcmahon/events{/privacy}","received_events_url":"https://api.github.com/users/david-mcmahon/received_events","type":"User","site_admin":false},"body":"Some minor formatting changes.\r\nAdd semver.org reference to file.","created_at":"2016-01-08T18:44:46Z","updated_at":"2016-01-15T20:53:10Z","closed_at":null,"merged_at":null,"merge_commit_sha":"c683f86f89c560ffe6ec4e5b0c4d9957bd3a7536","assignee":{"login":"ihmccreery","id":368416,"avatar_url":"https://avatars.githubusercontent.com/u/368416?v=3","gravatar_id":"","url":"https://api.github.com/users/ihmccreery","html_url":"https://github.com/ihmccreery","followers_url":"https://api.github.com/users/ihmccreery/followers","following_url":"https://api.github.com/users/ihmccreery/following{/other_user}","gists_url":"https://api.github.com/users/ihmccreery/gists{/gist_id}","starred_url":"https://api.github.com/users/ihmccreery/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ihmccreery/subscriptions","organizations_url":"https://api.github.com/users/ihmccreery/orgs","repos_url":"https://api.github.com/users/ihmccreery/repos","events_url":"https://api.github.com/users/ihmccreery/events{/privacy}","received_events_url":"https://api.github.com/users/ihmccreery/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424/commits","review_comments_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424/comments","review_comment_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/19424/comments","statuses_url":"https://api.github.com/repos/kubernetes/kubernetes/statuses/00acd78b343f204fd2eafc9c66254c35582dee80","head":{"label":"david-mcmahon:versioning","ref":"versioning","sha":"00acd78b343f204fd2eafc9c66254c35582dee80","user":{"login":"david-mcmahon","id":15622407,"avatar_url":"https://avatars.githubusercontent.com/u/15622407?v=3","gravatar_id":"","url":"https://api.github.com/users/david-mcmahon","html_url":"https://github.com/david-mcmahon","followers_url":"https://api.github.com/users/david-mcmahon/followers","following_url":"https://api.github.com/users/david-mcmahon/following{/other_user}","gists_url":"https://api.github.com/users/david-mcmahon/gists{/gist_id}","starred_url":"https://api.github.com/users/david-mcmahon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/david-mcmahon/subscriptions","organizations_url":"https://api.github.com/users/david-mcmahon/orgs","repos_url":"https://api.github.com/users/david-mcmahon/repos","events_url":"https://api.github.com/users/david-mcmahon/events{/privacy}","received_events_url":"https://api.github.com/users/david-mcmahon/received_events","type":"User","site_admin":false},"repo":{"id":49242094,"name":"kubernetes","full_name":"david-mcmahon/kubernetes","owner":{"login":"david-mcmahon","id":15622407,"avatar_url":"https://avatars.githubusercontent.com/u/15622407?v=3","gravatar_id":"","url":"https://api.github.com/users/david-mcmahon","html_url":"https://github.com/david-mcmahon","followers_url":"https://api.github.com/users/david-mcmahon/followers","following_url":"https://api.github.com/users/david-mcmahon/following{/other_user}","gists_url":"https://api.github.com/users/david-mcmahon/gists{/gist_id}","starred_url":"https://api.github.com/users/david-mcmahon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/david-mcmahon/subscriptions","organizations_url":"https://api.github.com/users/david-mcmahon/orgs","repos_url":"https://api.github.com/users/david-mcmahon/repos","events_url":"https://api.github.com/users/david-mcmahon/events{/privacy}","received_events_url":"https://api.github.com/users/david-mcmahon/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/david-mcmahon/kubernetes","description":"Container Cluster Manager from Google","fork":true,"url":"https://api.github.com/repos/david-mcmahon/kubernetes","forks_url":"https://api.github.com/repos/david-mcmahon/kubernetes/forks","keys_url":"https://api.github.com/repos/david-mcmahon/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/david-mcmahon/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/david-mcmahon/kubernetes/teams","hooks_url":"https://api.github.com/repos/david-mcmahon/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/david-mcmahon/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/david-mcmahon/kubernetes/events","assignees_url":"https://api.github.com/repos/david-mcmahon/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/david-mcmahon/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/david-mcmahon/kubernetes/tags","blobs_url":"https://api.github.com/repos/david-mcmahon/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/david-mcmahon/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/david-mcmahon/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/david-mcmahon/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/david-mcmahon/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/david-mcmahon/kubernetes/languages","stargazers_url":"https://api.github.com/repos/david-mcmahon/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/david-mcmahon/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/david-mcmahon/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/david-mcmahon/kubernetes/subscription","commits_url":"https://api.github.com/repos/david-mcmahon/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/david-mcmahon/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/david-mcmahon/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/david-mcmahon/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/david-mcmahon/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/david-mcmahon/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/david-mcmahon/kubernetes/merges","archive_url":"https://api.github.com/repos/david-mcmahon/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/david-mcmahon/kubernetes/downloads","issues_url":"https://api.github.com/repos/david-mcmahon/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/david-mcmahon/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/david-mcmahon/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/david-mcmahon/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/david-mcmahon/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/david-mcmahon/kubernetes/releases{/id}","created_at":"2016-01-08T01:45:12Z","updated_at":"2016-01-08T01:45:22Z","pushed_at":"2016-01-12T23:51:52Z","git_url":"git://github.com/david-mcmahon/kubernetes.git","ssh_url":"git@github.com:david-mcmahon/kubernetes.git","clone_url":"https://github.com/david-mcmahon/kubernetes.git","svn_url":"https://github.com/david-mcmahon/kubernetes","homepage":"http://kubernetes.io","size":149838,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"kubernetes:master","ref":"master","sha":"bf763bba95b826264a64baa4398fe147860e6b35","user":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"repo":{"id":20580498,"name":"kubernetes","full_name":"kubernetes/kubernetes","owner":{"login":"kubernetes","id":13629408,"avatar_url":"https://avatars.githubusercontent.com/u/13629408?v=3","gravatar_id":"","url":"https://api.github.com/users/kubernetes","html_url":"https://github.com/kubernetes","followers_url":"https://api.github.com/users/kubernetes/followers","following_url":"https://api.github.com/users/kubernetes/following{/other_user}","gists_url":"https://api.github.com/users/kubernetes/gists{/gist_id}","starred_url":"https://api.github.com/users/kubernetes/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kubernetes/subscriptions","organizations_url":"https://api.github.com/users/kubernetes/orgs","repos_url":"https://api.github.com/users/kubernetes/repos","events_url":"https://api.github.com/users/kubernetes/events{/privacy}","received_events_url":"https://api.github.com/users/kubernetes/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kubernetes/kubernetes","description":"Container Cluster Manager from Google","fork":false,"url":"https://api.github.com/repos/kubernetes/kubernetes","forks_url":"https://api.github.com/repos/kubernetes/kubernetes/forks","keys_url":"https://api.github.com/repos/kubernetes/kubernetes/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kubernetes/kubernetes/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kubernetes/kubernetes/teams","hooks_url":"https://api.github.com/repos/kubernetes/kubernetes/hooks","issue_events_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/events{/number}","events_url":"https://api.github.com/repos/kubernetes/kubernetes/events","assignees_url":"https://api.github.com/repos/kubernetes/kubernetes/assignees{/user}","branches_url":"https://api.github.com/repos/kubernetes/kubernetes/branches{/branch}","tags_url":"https://api.github.com/repos/kubernetes/kubernetes/tags","blobs_url":"https://api.github.com/repos/kubernetes/kubernetes/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kubernetes/kubernetes/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kubernetes/kubernetes/git/refs{/sha}","trees_url":"https://api.github.com/repos/kubernetes/kubernetes/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kubernetes/kubernetes/statuses/{sha}","languages_url":"https://api.github.com/repos/kubernetes/kubernetes/languages","stargazers_url":"https://api.github.com/repos/kubernetes/kubernetes/stargazers","contributors_url":"https://api.github.com/repos/kubernetes/kubernetes/contributors","subscribers_url":"https://api.github.com/repos/kubernetes/kubernetes/subscribers","subscription_url":"https://api.github.com/repos/kubernetes/kubernetes/subscription","commits_url":"https://api.github.com/repos/kubernetes/kubernetes/commits{/sha}","git_commits_url":"https://api.github.com/repos/kubernetes/kubernetes/git/commits{/sha}","comments_url":"https://api.github.com/repos/kubernetes/kubernetes/comments{/number}","issue_comment_url":"https://api.github.com/repos/kubernetes/kubernetes/issues/comments{/number}","contents_url":"https://api.github.com/repos/kubernetes/kubernetes/contents/{+path}","compare_url":"https://api.github.com/repos/kubernetes/kubernetes/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kubernetes/kubernetes/merges","archive_url":"https://api.github.com/repos/kubernetes/kubernetes/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kubernetes/kubernetes/downloads","issues_url":"https://api.github.com/repos/kubernetes/kubernetes/issues{/number}","pulls_url":"https://api.github.com/repos/kubernetes/kubernetes/pulls{/number}","milestones_url":"https://api.github.com/repos/kubernetes/kubernetes/milestones{/number}","notifications_url":"https://api.github.com/repos/kubernetes/kubernetes/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kubernetes/kubernetes/labels{/name}","releases_url":"https://api.github.com/repos/kubernetes/kubernetes/releases{/id}","created_at":"2014-06-06T22:56:04Z","updated_at":"2016-01-15T20:38:49Z","pushed_at":"2016-01-15T20:42:54Z","git_url":"git://github.com/kubernetes/kubernetes.git","ssh_url":"git@github.com:kubernetes/kubernetes.git","clone_url":"https://github.com/kubernetes/kubernetes.git","svn_url":"https://github.com/kubernetes/kubernetes","homepage":"http://kubernetes.io","size":304412,"stargazers_count":12155,"watchers_count":12155,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":3417,"mirror_url":null,"open_issues_count":2794,"forks":3417,"open_issues":2794,"watchers":12155,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424"},"html":{"href":"https://github.com/kubernetes/kubernetes/pull/19424"},"issue":{"href":"https://api.github.com/repos/kubernetes/kubernetes/issues/19424"},"comments":{"href":"https://api.github.com/repos/kubernetes/kubernetes/issues/19424/comments"},"review_comments":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424/comments"},"review_comment":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kubernetes/kubernetes/pulls/19424/commits"},"statuses":{"href":"https://api.github.com/repos/kubernetes/kubernetes/statuses/00acd78b343f204fd2eafc9c66254c35582dee80"}}}}