{"action":"created","comment":{"url":"https://api.github.com/repos/dotnet/arcade/pulls/comments/211686217","pull_request_review_id":148160863,"id":211686217,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIxMTY4NjIxNw==","diff_hunk":"@@ -0,0 +1,864 @@\n+# Channels, Branches and Subscriptions\n+\n+This document describes the concepts of channels, branches and subscriptions in the .NET Core 3.0 (ProdCon v2) world as well as workflow and management.\n+\n+## Introduction\n+\n+For .NET Core 3, the engineering system must be able to support a number of core construction scenarios, including:\n+- Builds involving custom branches for various parts of the stack (e.g. long lived feature work).\n+- Builds for a new release.\n+- Builds involving stabilized assets (that are only published after validation).\n+- Internal only builds.\n+- Non-validated builds.\n+- Speculative builds (see https://github.com/dotnet/arcade/blob/master/Documentation/Maestro.md#speculative-version-flow).\n+- Upstack builds on PRs.\n+\n+In Prodcon v2, there are a number of central principals that shape how the product is constructed:\n+- The product is spread among many repositories, with inter-repo dependencies expressed as pointers to build assets.  The pointers normally take the form of version number and name of asset.\n+- All product changes must be commits.  These commits alter *Branches*.\n+  \n+  *In prodcon v1, inter-repo dependency updates were forced via a dependency info file that was passed into the build.*\n+- If the inter-repo dependency graph has a maximal depth N, then N commits are required for a complete alteration of the product output.\n+- Branches do not generally define the inteded use of the code in the branch.  This is defined by the *Channel* a build of that branch is assigned.","path":"Documentation/BranchesChannelsAndSubscriptions.md","position":22,"original_position":22,"commit_id":"dcbc16364484761de46c7cc9cb33275553ce1d5f","original_commit_id":"dcbc16364484761de46c7cc9cb33275553ce1d5f","user":{"login":"maririos","id":9868623,"node_id":"MDQ6VXNlcjk4Njg2MjM=","avatar_url":"https://avatars0.githubusercontent.com/u/9868623?v=4","gravatar_id":"","url":"https://api.github.com/users/maririos","html_url":"https://github.com/maririos","followers_url":"https://api.github.com/users/maririos/followers","following_url":"https://api.github.com/users/maririos/following{/other_user}","gists_url":"https://api.github.com/users/maririos/gists{/gist_id}","starred_url":"https://api.github.com/users/maririos/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/maririos/subscriptions","organizations_url":"https://api.github.com/users/maririos/orgs","repos_url":"https://api.github.com/users/maririos/repos","events_url":"https://api.github.com/users/maririos/events{/privacy}","received_events_url":"https://api.github.com/users/maririos/received_events","type":"User","site_admin":false},"body":"the wording here is weird. => \r\n- Branches do not generally define the intended use of the code in the branch. This is defined by the *Channel*. \r\n- A build of a branch is assigned to 1 or more channels (not sure here if it is to one channel or it could be one or more)","created_at":"2018-08-21T17:10:52Z","updated_at":"2018-08-21T17:10:52Z","html_url":"https://github.com/dotnet/arcade/pull/482#discussion_r211686217","pull_request_url":"https://api.github.com/repos/dotnet/arcade/pulls/482","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/dotnet/arcade/pulls/comments/211686217"},"html":{"href":"https://github.com/dotnet/arcade/pull/482#discussion_r211686217"},"pull_request":{"href":"https://api.github.com/repos/dotnet/arcade/pulls/482"}}},"pull_request":{"url":"https://api.github.com/repos/dotnet/arcade/pulls/482","id":209270873,"node_id":"MDExOlB1bGxSZXF1ZXN0MjA5MjcwODcz","html_url":"https://github.com/dotnet/arcade/pull/482","diff_url":"https://github.com/dotnet/arcade/pull/482.diff","patch_url":"https://github.com/dotnet/arcade/pull/482.patch","issue_url":"https://api.github.com/repos/dotnet/arcade/issues/482","number":482,"state":"open","locked":false,"title":"Initial draft of branch/channel and subscription management.","user":{"login":"mmitche","id":8725170,"node_id":"MDQ6VXNlcjg3MjUxNzA=","avatar_url":"https://avatars1.githubusercontent.com/u/8725170?v=4","gravatar_id":"","url":"https://api.github.com/users/mmitche","html_url":"https://github.com/mmitche","followers_url":"https://api.github.com/users/mmitche/followers","following_url":"https://api.github.com/users/mmitche/following{/other_user}","gists_url":"https://api.github.com/users/mmitche/gists{/gist_id}","starred_url":"https://api.github.com/users/mmitche/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mmitche/subscriptions","organizations_url":"https://api.github.com/users/mmitche/orgs","repos_url":"https://api.github.com/users/mmitche/repos","events_url":"https://api.github.com/users/mmitche/events{/privacy}","received_events_url":"https://api.github.com/users/mmitche/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-08-17T22:23:32Z","updated_at":"2018-08-21T17:10:52Z","closed_at":null,"merged_at":null,"merge_commit_sha":"fee5353078b21727431f9bd2a72b758876b37937","assignee":null,"assignees":[],"requested_reviewers":[{"login":"jaredpar","id":146967,"node_id":"MDQ6VXNlcjE0Njk2Nw==","avatar_url":"https://avatars0.githubusercontent.com/u/146967?v=4","gravatar_id":"","url":"https://api.github.com/users/jaredpar","html_url":"https://github.com/jaredpar","followers_url":"https://api.github.com/users/jaredpar/followers","following_url":"https://api.github.com/users/jaredpar/following{/other_user}","gists_url":"https://api.github.com/users/jaredpar/gists{/gist_id}","starred_url":"https://api.github.com/users/jaredpar/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jaredpar/subscriptions","organizations_url":"https://api.github.com/users/jaredpar/orgs","repos_url":"https://api.github.com/users/jaredpar/repos","events_url":"https://api.github.com/users/jaredpar/events{/privacy}","received_events_url":"https://api.github.com/users/jaredpar/received_events","type":"User","site_admin":false},{"login":"weshaggard","id":9010698,"node_id":"MDQ6VXNlcjkwMTA2OTg=","avatar_url":"https://avatars2.githubusercontent.com/u/9010698?v=4","gravatar_id":"","url":"https://api.github.com/users/weshaggard","html_url":"https://github.com/weshaggard","followers_url":"https://api.github.com/users/weshaggard/followers","following_url":"https://api.github.com/users/weshaggard/following{/other_user}","gists_url":"https://api.github.com/users/weshaggard/gists{/gist_id}","starred_url":"https://api.github.com/users/weshaggard/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/weshaggard/subscriptions","organizations_url":"https://api.github.com/users/weshaggard/orgs","repos_url":"https://api.github.com/users/weshaggard/repos","events_url":"https://api.github.com/users/weshaggard/events{/privacy}","received_events_url":"https://api.github.com/users/weshaggard/received_events","type":"User","site_admin":false},{"login":"chcosta","id":10092143,"node_id":"MDQ6VXNlcjEwMDkyMTQz","avatar_url":"https://avatars3.githubusercontent.com/u/10092143?v=4","gravatar_id":"","url":"https://api.github.com/users/chcosta","html_url":"https://github.com/chcosta","followers_url":"https://api.github.com/users/chcosta/followers","following_url":"https://api.github.com/users/chcosta/following{/other_user}","gists_url":"https://api.github.com/users/chcosta/gists{/gist_id}","starred_url":"https://api.github.com/users/chcosta/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chcosta/subscriptions","organizations_url":"https://api.github.com/users/chcosta/orgs","repos_url":"https://api.github.com/users/chcosta/repos","events_url":"https://api.github.com/users/chcosta/events{/privacy}","received_events_url":"https://api.github.com/users/chcosta/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/dotnet/arcade/pulls/482/commits","review_comments_url":"https://api.github.com/repos/dotnet/arcade/pulls/482/comments","review_comment_url":"https://api.github.com/repos/dotnet/arcade/pulls/comments{/number}","comments_url":"https://api.github.com/repos/dotnet/arcade/issues/482/comments","statuses_url":"https://api.github.com/repos/dotnet/arcade/statuses/dcbc16364484761de46c7cc9cb33275553ce1d5f","head":{"label":"mmitche:channel-management","ref":"channel-management","sha":"dcbc16364484761de46c7cc9cb33275553ce1d5f","user":{"login":"mmitche","id":8725170,"node_id":"MDQ6VXNlcjg3MjUxNzA=","avatar_url":"https://avatars1.githubusercontent.com/u/8725170?v=4","gravatar_id":"","url":"https://api.github.com/users/mmitche","html_url":"https://github.com/mmitche","followers_url":"https://api.github.com/users/mmitche/followers","following_url":"https://api.github.com/users/mmitche/following{/other_user}","gists_url":"https://api.github.com/users/mmitche/gists{/gist_id}","starred_url":"https://api.github.com/users/mmitche/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mmitche/subscriptions","organizations_url":"https://api.github.com/users/mmitche/orgs","repos_url":"https://api.github.com/users/mmitche/repos","events_url":"https://api.github.com/users/mmitche/events{/privacy}","received_events_url":"https://api.github.com/users/mmitche/received_events","type":"User","site_admin":false},"repo":{"id":125901669,"node_id":"MDEwOlJlcG9zaXRvcnkxMjU5MDE2Njk=","name":"arcade","full_name":"mmitche/arcade","owner":{"login":"mmitche","id":8725170,"node_id":"MDQ6VXNlcjg3MjUxNzA=","avatar_url":"https://avatars1.githubusercontent.com/u/8725170?v=4","gravatar_id":"","url":"https://api.github.com/users/mmitche","html_url":"https://github.com/mmitche","followers_url":"https://api.github.com/users/mmitche/followers","following_url":"https://api.github.com/users/mmitche/following{/other_user}","gists_url":"https://api.github.com/users/mmitche/gists{/gist_id}","starred_url":"https://api.github.com/users/mmitche/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mmitche/subscriptions","organizations_url":"https://api.github.com/users/mmitche/orgs","repos_url":"https://api.github.com/users/mmitche/repos","events_url":"https://api.github.com/users/mmitche/events{/privacy}","received_events_url":"https://api.github.com/users/mmitche/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/mmitche/arcade","description":"Tools that provide common build infrastructure for multiple .NET Foundation projects.","fork":true,"url":"https://api.github.com/repos/mmitche/arcade","forks_url":"https://api.github.com/repos/mmitche/arcade/forks","keys_url":"https://api.github.com/repos/mmitche/arcade/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mmitche/arcade/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mmitche/arcade/teams","hooks_url":"https://api.github.com/repos/mmitche/arcade/hooks","issue_events_url":"https://api.github.com/repos/mmitche/arcade/issues/events{/number}","events_url":"https://api.github.com/repos/mmitche/arcade/events","assignees_url":"https://api.github.com/repos/mmitche/arcade/assignees{/user}","branches_url":"https://api.github.com/repos/mmitche/arcade/branches{/branch}","tags_url":"https://api.github.com/repos/mmitche/arcade/tags","blobs_url":"https://api.github.com/repos/mmitche/arcade/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mmitche/arcade/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mmitche/arcade/git/refs{/sha}","trees_url":"https://api.github.com/repos/mmitche/arcade/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mmitche/arcade/statuses/{sha}","languages_url":"https://api.github.com/repos/mmitche/arcade/languages","stargazers_url":"https://api.github.com/repos/mmitche/arcade/stargazers","contributors_url":"https://api.github.com/repos/mmitche/arcade/contributors","subscribers_url":"https://api.github.com/repos/mmitche/arcade/subscribers","subscription_url":"https://api.github.com/repos/mmitche/arcade/subscription","commits_url":"https://api.github.com/repos/mmitche/arcade/commits{/sha}","git_commits_url":"https://api.github.com/repos/mmitche/arcade/git/commits{/sha}","comments_url":"https://api.github.com/repos/mmitche/arcade/comments{/number}","issue_comment_url":"https://api.github.com/repos/mmitche/arcade/issues/comments{/number}","contents_url":"https://api.github.com/repos/mmitche/arcade/contents/{+path}","compare_url":"https://api.github.com/repos/mmitche/arcade/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mmitche/arcade/merges","archive_url":"https://api.github.com/repos/mmitche/arcade/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mmitche/arcade/downloads","issues_url":"https://api.github.com/repos/mmitche/arcade/issues{/number}","pulls_url":"https://api.github.com/repos/mmitche/arcade/pulls{/number}","milestones_url":"https://api.github.com/repos/mmitche/arcade/milestones{/number}","notifications_url":"https://api.github.com/repos/mmitche/arcade/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mmitche/arcade/labels{/name}","releases_url":"https://api.github.com/repos/mmitche/arcade/releases{/id}","deployments_url":"https://api.github.com/repos/mmitche/arcade/deployments","created_at":"2018-03-19T18:18:12Z","updated_at":"2018-07-31T20:44:48Z","pushed_at":"2018-08-21T16:56:13Z","git_url":"git://github.com/mmitche/arcade.git","ssh_url":"git@github.com:mmitche/arcade.git","clone_url":"https://github.com/mmitche/arcade.git","svn_url":"https://github.com/mmitche/arcade","homepage":"","size":2693,"stargazers_count":0,"watchers_count":0,"language":"C#","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"dotnet:master","ref":"master","sha":"ae1e69fb5e917eaede4c1a1f1ac84dd9c73094c6","user":{"login":"dotnet","id":9141961,"node_id":"MDEyOk9yZ2FuaXphdGlvbjkxNDE5NjE=","avatar_url":"https://avatars0.githubusercontent.com/u/9141961?v=4","gravatar_id":"","url":"https://api.github.com/users/dotnet","html_url":"https://github.com/dotnet","followers_url":"https://api.github.com/users/dotnet/followers","following_url":"https://api.github.com/users/dotnet/following{/other_user}","gists_url":"https://api.github.com/users/dotnet/gists{/gist_id}","starred_url":"https://api.github.com/users/dotnet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dotnet/subscriptions","organizations_url":"https://api.github.com/users/dotnet/orgs","repos_url":"https://api.github.com/users/dotnet/repos","events_url":"https://api.github.com/users/dotnet/events{/privacy}","received_events_url":"https://api.github.com/users/dotnet/received_events","type":"Organization","site_admin":false},"repo":{"id":121444325,"node_id":"MDEwOlJlcG9zaXRvcnkxMjE0NDQzMjU=","name":"arcade","full_name":"dotnet/arcade","owner":{"login":"dotnet","id":9141961,"node_id":"MDEyOk9yZ2FuaXphdGlvbjkxNDE5NjE=","avatar_url":"https://avatars0.githubusercontent.com/u/9141961?v=4","gravatar_id":"","url":"https://api.github.com/users/dotnet","html_url":"https://github.com/dotnet","followers_url":"https://api.github.com/users/dotnet/followers","following_url":"https://api.github.com/users/dotnet/following{/other_user}","gists_url":"https://api.github.com/users/dotnet/gists{/gist_id}","starred_url":"https://api.github.com/users/dotnet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dotnet/subscriptions","organizations_url":"https://api.github.com/users/dotnet/orgs","repos_url":"https://api.github.com/users/dotnet/repos","events_url":"https://api.github.com/users/dotnet/events{/privacy}","received_events_url":"https://api.github.com/users/dotnet/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/dotnet/arcade","description":"Tools that provide common build infrastructure for multiple .NET Foundation projects.","fork":false,"url":"https://api.github.com/repos/dotnet/arcade","forks_url":"https://api.github.com/repos/dotnet/arcade/forks","keys_url":"https://api.github.com/repos/dotnet/arcade/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dotnet/arcade/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dotnet/arcade/teams","hooks_url":"https://api.github.com/repos/dotnet/arcade/hooks","issue_events_url":"https://api.github.com/repos/dotnet/arcade/issues/events{/number}","events_url":"https://api.github.com/repos/dotnet/arcade/events","assignees_url":"https://api.github.com/repos/dotnet/arcade/assignees{/user}","branches_url":"https://api.github.com/repos/dotnet/arcade/branches{/branch}","tags_url":"https://api.github.com/repos/dotnet/arcade/tags","blobs_url":"https://api.github.com/repos/dotnet/arcade/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dotnet/arcade/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dotnet/arcade/git/refs{/sha}","trees_url":"https://api.github.com/repos/dotnet/arcade/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dotnet/arcade/statuses/{sha}","languages_url":"https://api.github.com/repos/dotnet/arcade/languages","stargazers_url":"https://api.github.com/repos/dotnet/arcade/stargazers","contributors_url":"https://api.github.com/repos/dotnet/arcade/contributors","subscribers_url":"https://api.github.com/repos/dotnet/arcade/subscribers","subscription_url":"https://api.github.com/repos/dotnet/arcade/subscription","commits_url":"https://api.github.com/repos/dotnet/arcade/commits{/sha}","git_commits_url":"https://api.github.com/repos/dotnet/arcade/git/commits{/sha}","comments_url":"https://api.github.com/repos/dotnet/arcade/comments{/number}","issue_comment_url":"https://api.github.com/repos/dotnet/arcade/issues/comments{/number}","contents_url":"https://api.github.com/repos/dotnet/arcade/contents/{+path}","compare_url":"https://api.github.com/repos/dotnet/arcade/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dotnet/arcade/merges","archive_url":"https://api.github.com/repos/dotnet/arcade/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dotnet/arcade/downloads","issues_url":"https://api.github.com/repos/dotnet/arcade/issues{/number}","pulls_url":"https://api.github.com/repos/dotnet/arcade/pulls{/number}","milestones_url":"https://api.github.com/repos/dotnet/arcade/milestones{/number}","notifications_url":"https://api.github.com/repos/dotnet/arcade/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dotnet/arcade/labels{/name}","releases_url":"https://api.github.com/repos/dotnet/arcade/releases{/id}","deployments_url":"https://api.github.com/repos/dotnet/arcade/deployments","created_at":"2018-02-13T22:29:54Z","updated_at":"2018-08-20T20:57:08Z","pushed_at":"2018-08-21T16:56:14Z","git_url":"git://github.com/dotnet/arcade.git","ssh_url":"git@github.com:dotnet/arcade.git","clone_url":"https://github.com/dotnet/arcade.git","svn_url":"https://github.com/dotnet/arcade","homepage":"","size":2850,"stargazers_count":12,"watchers_count":12,"language":"C#","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":23,"mirror_url":null,"archived":false,"open_issues_count":178,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":23,"open_issues":178,"watchers":12,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/dotnet/arcade/pulls/482"},"html":{"href":"https://github.com/dotnet/arcade/pull/482"},"issue":{"href":"https://api.github.com/repos/dotnet/arcade/issues/482"},"comments":{"href":"https://api.github.com/repos/dotnet/arcade/issues/482/comments"},"review_comments":{"href":"https://api.github.com/repos/dotnet/arcade/pulls/482/comments"},"review_comment":{"href":"https://api.github.com/repos/dotnet/arcade/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/dotnet/arcade/pulls/482/commits"},"statuses":{"href":"https://api.github.com/repos/dotnet/arcade/statuses/dcbc16364484761de46c7cc9cb33275553ce1d5f"}},"author_association":"MEMBER"}}
{"actor":{"display_login":"maririos"}}