{"action":"created","comment":{"url":"https://api.github.com/repos/dotnet/cli/pulls/comments/55876344","id":55876344,"diff_hunk":"@@ -0,0 +1,243 @@\n+# Notes\r\n+This section describes placeholders used inside this spec.\r\n+\r\n+| Placeholder | Description |\r\n+| ---: | :--- |\r\n+| `<Channel>` | `(future|preview|production)`. [See more info](#channels) |\r\n+| `<Version>` | 4-part-number version |\r\n+| `<OSName>`  | `(win|ubuntu|rhel|osx|debian)` - code for OS name |\r\n+| `<LowestSupportedOSVersion>` | Lowest supported OS Version |\r\n+| `<Architecture>` | Processor architecture related to binaries produced |\r\n+| `<Extension>` | File extension. This will be described in more details later for each OS separately. |\r\n+| `<OSID>` | Abbreviation for: `<OSName><LowestSupportedOSVersion>.<Architecture>`. [See more info](#osid) |\r\n+| `<VersionPointer>` | `(latest|lkg)` |\r\n+| `<ExecutableExtension>` | Executable extension including dot specific to OS (can be empty string) |\r\n+| `<CommitHash>` | Commit hash related to state of repository from where build with specific `<Version>` was build |\r\n+| `<DebianPackageName>` | Name of the debian package. [See more info](#debian-feed-relation) |\r\n+\r\n+# Build Output\r\n+Each official, successful build should create and upload packages to location described by following URL:\r\n+```\r\n+https://dotnetcli.blob.core.windows.net/dotnet/<Channel>/<Version>/dotnet.<OSID>.<Version>.<Extension>\r\n+```\r\n+Content of the package should contain binaries which layout will be described later.\r\n+\r\n+Additionally each build should update `latest` [version descriptors](#version-descriptors)\r\n+\r\n+## Windows output\r\n+\r\n+Nuget - WIP, this should include versioning scheme\r\n+\r\n+| `<Extension>` | Description |\r\n+| --- | :--- |\r\n+| exe | Installer bundle. It should be used by end customers |\r\n+| zip | Packed binaries. Used by [installation script](#installation-scripts) |\r\n+| symbols.zip | Packed binaries with included symbols. See [symbol packages](#symbol-packages) |\r\n+\r\n+### Including dotnet cli installer as part of your bundle\r\n+\r\n+In order to install dotnet cli with other installer you need an MSI package. To get MSI, download exe bundle and extract it using `dark` tool which is part of [WiX Toolset](http://wixtoolset.org):\r\n+```\r\n+dark.exe -x <FolderWhereToExtract> <InstallerPath>\r\n+```\r\n+\r\n+## OSX output\r\n+\r\n+| `<Extension>` | Description |\r\n+| --- | :--- |\r\n+| pkg | WIP |\r\n+| tar.gz | Packed binaries. Used by [installation script](#installation-scripts) |\r\n+| symbols.tar.gz | Packed binaries with included symbols. See [symbol packages](#symbol-packages) |\r\n+\r\n+## Ubuntu output\r\n+\r\n+| `<Extension>` | Description |\r\n+| --- | :--- |\r\n+| deb | Debian package. This package is being pushed to a [debian feed](#debian-feed) |\r\n+| tar.gz | Packed binaries. Used by [installation script](#installation-scripts) |\r\n+| symbols.tar.gz | Packed binaries with included symbols. See [symbol packages](#symbol-packages) |\r\n+\r\n+## RedHat/CentOS output\r\n+\r\n+| `<Extension>` | Description |\r\n+| --- | :--- |\r\n+| tar.gz | Packed binaries. Used by [installation script](#installation-scripts) |\r\n+| symbols.tar.gz | Packed binaries with included symbols. See [symbol packages](#symbol-packages) |\r\n+\r\n+## Debian output\r\n+\r\n+| `<Extension>` | Description |\r\n+| --- | :--- |\r\n+| tar.gz | Packed binaries. Used by [installation script](#installation-scripts) |\r\n+| symbols.tar.gz | Packed binaries with included symbols. See [symbol packages](#symbol-packages) |\r\n+\r\n+## Example build output links\r\n+WIP\r\n+\r\n+## Questions\r\n+- Should <Version> include channel name to avoid situation where you have two files on your computer and latest file might have lower version than the newest?\r\n+\r\n+# Obtaining dotnet\r\n+\r\n+## Installation scripts\r\n+\r\n+Installation script is a shell script which lets customers install dotnet.\r\n+\r\n+For Windows we are using PowerShell script (install-dotnet.ps1).\r\n+For any other OS we are using bash script (install-dotnet.sh)\r\n+\r\n+WIP: Exact script action description.\r\n+\r\n+### Script arguments description\r\n+\r\n+| PowerShell script | Bash script | Default | Description |\r\n+| --- | --- | --- | --- |\r\n+| -Channel | --channel | production | Which [channel](#channels) to install from. Possible values: `future`, `preview`, `production` |\r","path":"Documentation/specs/installation-scenarios.md","position":95,"original_position":95,"commit_id":"0c215e4d2b745e10eacb9b39cd413946539b7f16","original_commit_id":"0c215e4d2b745e10eacb9b39cd413946539b7f16","user":{"login":"mellinoe","id":8918977,"avatar_url":"https://avatars.githubusercontent.com/u/8918977?v=3","gravatar_id":"","url":"https://api.github.com/users/mellinoe","html_url":"https://github.com/mellinoe","followers_url":"https://api.github.com/users/mellinoe/followers","following_url":"https://api.github.com/users/mellinoe/following{/other_user}","gists_url":"https://api.github.com/users/mellinoe/gists{/gist_id}","starred_url":"https://api.github.com/users/mellinoe/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mellinoe/subscriptions","organizations_url":"https://api.github.com/users/mellinoe/orgs","repos_url":"https://api.github.com/users/mellinoe/repos","events_url":"https://api.github.com/users/mellinoe/events{/privacy}","received_events_url":"https://api.github.com/users/mellinoe/received_events","type":"User","site_admin":false},"body":"We don't use powershell in corefx, but I've found that having different syntax for different scripting languages tends to be confusing, without any real benefit. I know some of the build scripts in here already use this style, but since these installer scripts would be more \"public-facing\" (i.e. anyone would use them, not just devs in the repo), we might want to consider making them uniform across platforms.","created_at":"2016-03-11T19:29:34Z","updated_at":"2016-03-11T19:29:34Z","html_url":"https://github.com/dotnet/cli/pull/1817#discussion_r55876344","pull_request_url":"https://api.github.com/repos/dotnet/cli/pulls/1817","_links":{"self":{"href":"https://api.github.com/repos/dotnet/cli/pulls/comments/55876344"},"html":{"href":"https://github.com/dotnet/cli/pull/1817#discussion_r55876344"},"pull_request":{"href":"https://api.github.com/repos/dotnet/cli/pulls/1817"}}},"pull_request":{"url":"https://api.github.com/repos/dotnet/cli/pulls/1817","id":62587075,"html_url":"https://github.com/dotnet/cli/pull/1817","diff_url":"https://github.com/dotnet/cli/pull/1817.diff","patch_url":"https://github.com/dotnet/cli/pull/1817.patch","issue_url":"https://api.github.com/repos/dotnet/cli/issues/1817","number":1817,"state":"open","locked":false,"title":"WIP: Installation scenarios spec","user":{"login":"krwq","id":660048,"avatar_url":"https://avatars.githubusercontent.com/u/660048?v=3","gravatar_id":"","url":"https://api.github.com/users/krwq","html_url":"https://github.com/krwq","followers_url":"https://api.github.com/users/krwq/followers","following_url":"https://api.github.com/users/krwq/following{/other_user}","gists_url":"https://api.github.com/users/krwq/gists{/gist_id}","starred_url":"https://api.github.com/users/krwq/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krwq/subscriptions","organizations_url":"https://api.github.com/users/krwq/orgs","repos_url":"https://api.github.com/users/krwq/repos","events_url":"https://api.github.com/users/krwq/events{/privacy}","received_events_url":"https://api.github.com/users/krwq/received_events","type":"User","site_admin":false},"body":"This includes mostly but not only file naming conventions\r\n","created_at":"2016-03-11T19:01:42Z","updated_at":"2016-03-11T19:29:34Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f6b365e2353b5d150cbf66fdb50b592a12435cea","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/dotnet/cli/pulls/1817/commits","review_comments_url":"https://api.github.com/repos/dotnet/cli/pulls/1817/comments","review_comment_url":"https://api.github.com/repos/dotnet/cli/pulls/comments{/number}","comments_url":"https://api.github.com/repos/dotnet/cli/issues/1817/comments","statuses_url":"https://api.github.com/repos/dotnet/cli/statuses/0c215e4d2b745e10eacb9b39cd413946539b7f16","head":{"label":"krwq:installation_spec","ref":"installation_spec","sha":"0c215e4d2b745e10eacb9b39cd413946539b7f16","user":{"login":"krwq","id":660048,"avatar_url":"https://avatars.githubusercontent.com/u/660048?v=3","gravatar_id":"","url":"https://api.github.com/users/krwq","html_url":"https://github.com/krwq","followers_url":"https://api.github.com/users/krwq/followers","following_url":"https://api.github.com/users/krwq/following{/other_user}","gists_url":"https://api.github.com/users/krwq/gists{/gist_id}","starred_url":"https://api.github.com/users/krwq/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krwq/subscriptions","organizations_url":"https://api.github.com/users/krwq/orgs","repos_url":"https://api.github.com/users/krwq/repos","events_url":"https://api.github.com/users/krwq/events{/privacy}","received_events_url":"https://api.github.com/users/krwq/received_events","type":"User","site_admin":false},"repo":{"id":46476858,"name":"cli","full_name":"krwq/cli","owner":{"login":"krwq","id":660048,"avatar_url":"https://avatars.githubusercontent.com/u/660048?v=3","gravatar_id":"","url":"https://api.github.com/users/krwq","html_url":"https://github.com/krwq","followers_url":"https://api.github.com/users/krwq/followers","following_url":"https://api.github.com/users/krwq/following{/other_user}","gists_url":"https://api.github.com/users/krwq/gists{/gist_id}","starred_url":"https://api.github.com/users/krwq/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/krwq/subscriptions","organizations_url":"https://api.github.com/users/krwq/orgs","repos_url":"https://api.github.com/users/krwq/repos","events_url":"https://api.github.com/users/krwq/events{/privacy}","received_events_url":"https://api.github.com/users/krwq/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/krwq/cli","description":"This repo contains the .NET Core command-line (CLI) tools, used for building .NET Core apps and libraries through your development flow (compiling, NuGet package management, running, testing, ...).","fork":true,"url":"https://api.github.com/repos/krwq/cli","forks_url":"https://api.github.com/repos/krwq/cli/forks","keys_url":"https://api.github.com/repos/krwq/cli/keys{/key_id}","collaborators_url":"https://api.github.com/repos/krwq/cli/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/krwq/cli/teams","hooks_url":"https://api.github.com/repos/krwq/cli/hooks","issue_events_url":"https://api.github.com/repos/krwq/cli/issues/events{/number}","events_url":"https://api.github.com/repos/krwq/cli/events","assignees_url":"https://api.github.com/repos/krwq/cli/assignees{/user}","branches_url":"https://api.github.com/repos/krwq/cli/branches{/branch}","tags_url":"https://api.github.com/repos/krwq/cli/tags","blobs_url":"https://api.github.com/repos/krwq/cli/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/krwq/cli/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/krwq/cli/git/refs{/sha}","trees_url":"https://api.github.com/repos/krwq/cli/git/trees{/sha}","statuses_url":"https://api.github.com/repos/krwq/cli/statuses/{sha}","languages_url":"https://api.github.com/repos/krwq/cli/languages","stargazers_url":"https://api.github.com/repos/krwq/cli/stargazers","contributors_url":"https://api.github.com/repos/krwq/cli/contributors","subscribers_url":"https://api.github.com/repos/krwq/cli/subscribers","subscription_url":"https://api.github.com/repos/krwq/cli/subscription","commits_url":"https://api.github.com/repos/krwq/cli/commits{/sha}","git_commits_url":"https://api.github.com/repos/krwq/cli/git/commits{/sha}","comments_url":"https://api.github.com/repos/krwq/cli/comments{/number}","issue_comment_url":"https://api.github.com/repos/krwq/cli/issues/comments{/number}","contents_url":"https://api.github.com/repos/krwq/cli/contents/{+path}","compare_url":"https://api.github.com/repos/krwq/cli/compare/{base}...{head}","merges_url":"https://api.github.com/repos/krwq/cli/merges","archive_url":"https://api.github.com/repos/krwq/cli/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/krwq/cli/downloads","issues_url":"https://api.github.com/repos/krwq/cli/issues{/number}","pulls_url":"https://api.github.com/repos/krwq/cli/pulls{/number}","milestones_url":"https://api.github.com/repos/krwq/cli/milestones{/number}","notifications_url":"https://api.github.com/repos/krwq/cli/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/krwq/cli/labels{/name}","releases_url":"https://api.github.com/repos/krwq/cli/releases{/id}","deployments_url":"https://api.github.com/repos/krwq/cli/deployments","created_at":"2015-11-19T07:56:22Z","updated_at":"2016-02-12T19:10:35Z","pushed_at":"2016-03-11T19:09:26Z","git_url":"git://github.com/krwq/cli.git","ssh_url":"git@github.com:krwq/cli.git","clone_url":"https://github.com/krwq/cli.git","svn_url":"https://github.com/krwq/cli","homepage":"http://dotnet.github.io/","size":19062,"stargazers_count":0,"watchers_count":0,"language":"C#","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":"dotnet:rel/1.0.0","ref":"rel/1.0.0","sha":"429625061dc64bf1b8a53d140486b301612b2727","user":{"login":"dotnet","id":9141961,"avatar_url":"https://avatars.githubusercontent.com/u/9141961?v=3","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":43568107,"name":"cli","full_name":"dotnet/cli","owner":{"login":"dotnet","id":9141961,"avatar_url":"https://avatars.githubusercontent.com/u/9141961?v=3","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/cli","description":"This repo contains the .NET Core command-line (CLI) tools, used for building .NET Core apps and libraries through your development flow (compiling, NuGet package management, running, testing, ...).","fork":false,"url":"https://api.github.com/repos/dotnet/cli","forks_url":"https://api.github.com/repos/dotnet/cli/forks","keys_url":"https://api.github.com/repos/dotnet/cli/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dotnet/cli/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dotnet/cli/teams","hooks_url":"https://api.github.com/repos/dotnet/cli/hooks","issue_events_url":"https://api.github.com/repos/dotnet/cli/issues/events{/number}","events_url":"https://api.github.com/repos/dotnet/cli/events","assignees_url":"https://api.github.com/repos/dotnet/cli/assignees{/user}","branches_url":"https://api.github.com/repos/dotnet/cli/branches{/branch}","tags_url":"https://api.github.com/repos/dotnet/cli/tags","blobs_url":"https://api.github.com/repos/dotnet/cli/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dotnet/cli/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dotnet/cli/git/refs{/sha}","trees_url":"https://api.github.com/repos/dotnet/cli/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dotnet/cli/statuses/{sha}","languages_url":"https://api.github.com/repos/dotnet/cli/languages","stargazers_url":"https://api.github.com/repos/dotnet/cli/stargazers","contributors_url":"https://api.github.com/repos/dotnet/cli/contributors","subscribers_url":"https://api.github.com/repos/dotnet/cli/subscribers","subscription_url":"https://api.github.com/repos/dotnet/cli/subscription","commits_url":"https://api.github.com/repos/dotnet/cli/commits{/sha}","git_commits_url":"https://api.github.com/repos/dotnet/cli/git/commits{/sha}","comments_url":"https://api.github.com/repos/dotnet/cli/comments{/number}","issue_comment_url":"https://api.github.com/repos/dotnet/cli/issues/comments{/number}","contents_url":"https://api.github.com/repos/dotnet/cli/contents/{+path}","compare_url":"https://api.github.com/repos/dotnet/cli/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dotnet/cli/merges","archive_url":"https://api.github.com/repos/dotnet/cli/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dotnet/cli/downloads","issues_url":"https://api.github.com/repos/dotnet/cli/issues{/number}","pulls_url":"https://api.github.com/repos/dotnet/cli/pulls{/number}","milestones_url":"https://api.github.com/repos/dotnet/cli/milestones{/number}","notifications_url":"https://api.github.com/repos/dotnet/cli/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dotnet/cli/labels{/name}","releases_url":"https://api.github.com/repos/dotnet/cli/releases{/id}","deployments_url":"https://api.github.com/repos/dotnet/cli/deployments","created_at":"2015-10-02T18:03:15Z","updated_at":"2016-03-11T11:06:34Z","pushed_at":"2016-03-11T19:09:26Z","git_url":"git://github.com/dotnet/cli.git","ssh_url":"git@github.com:dotnet/cli.git","clone_url":"https://github.com/dotnet/cli.git","svn_url":"https://github.com/dotnet/cli","homepage":"http://dotnet.github.io/","size":20746,"stargazers_count":658,"watchers_count":658,"language":"C#","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":127,"mirror_url":null,"open_issues_count":513,"forks":127,"open_issues":513,"watchers":658,"default_branch":"rel/1.0.0"}},"_links":{"self":{"href":"https://api.github.com/repos/dotnet/cli/pulls/1817"},"html":{"href":"https://github.com/dotnet/cli/pull/1817"},"issue":{"href":"https://api.github.com/repos/dotnet/cli/issues/1817"},"comments":{"href":"https://api.github.com/repos/dotnet/cli/issues/1817/comments"},"review_comments":{"href":"https://api.github.com/repos/dotnet/cli/pulls/1817/comments"},"review_comment":{"href":"https://api.github.com/repos/dotnet/cli/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/dotnet/cli/pulls/1817/commits"},"statuses":{"href":"https://api.github.com/repos/dotnet/cli/statuses/0c215e4d2b745e10eacb9b39cd413946539b7f16"}}}}