{"action":"created","comment":{"url":"https://api.github.com/repos/dotnet/core-docs/pulls/comments/61814307","id":61814307,"diff_hunk":"@@ -0,0 +1,121 @@\n+# .NET Core Command Line Tools (CLI)\n+\n+## What is the .NET CLI?\n+.NET Core Command Line Interface is a new foundational cross-platform toolchain for developing \n+.NET Core applications. It is \"foundational\" because it is the primary layer on which other, \n+higher-level tools, such as Integrated Development Environments (IDEs), editors and \n+build orchestrators can build on. \n+\n+It is also cross-platform by default and has the same surface area on each of the supported platforms. This means that\n+when you learn how to use the tooling and you can use it the same way from any of the supported platforms. \n+\n+## Installation\n+As with any tooling, the first thing is to get the tools to your machine. Depending on your scenario, you can either \n+use the native installers to install the CLI or use the installation shell script.\n+\n+The native installers are primarily meant for developer's machines. The CLI is distributed using each supported platform's \n+native install mechanism, for instance DEB packages on Ubuntu or MSI bundles on Windows. These installers will install \n+and set up the environment as needed for the user to use the CLI immediately after the install. However, they also \n+require administrative privileges on the machine. You can view the installation instructions on the\n+[getting started page](https://aka.ms/dotnetcoregs).\n+\n+Install scripts, on the other hand, do not require administrative privileges. However, they will also not install any \n+prerequisites on the machine; you need to install all of the pre-requisites manually. The scripts are meant mostly for \n+setting up build servers or when you wish to install the tools without admin privileges (do note the pre-requisites \n+caveat above). You can find more information on the [install script reference topic](dotnet-install-script.md). If you are \n+interested in how to set up CLI on your CI build server you can take a look at the [CLI with CI servers](using-ci-with-cli.md) \n+document. \n+\n+By default, the CLI will install in a \"side-by-side\" (SxS) manner. This means that multiple versions of the CLI tools \n+can coexist at any given time on a single machine. How the correct version gets used is explained in more detail in \n+the [driver section](#driver) below. \n+\n+### What commands come in the box?\n+The following commands are installed by default:\n+\n+* [new](dotnet-new.md)\n+* [restore](dotnet-restore.md)\n+* [run](dotnet-run.md)\n+* [build](dotnet-build.md)\n+* [test](dotnet-test.md)\n+* [publish](dotnet-publish.md)\n+* [pack](dotnet-pack.md)\n+\n+Of course, there is a way to import more commands on a per-project basis as well as to add your commands. This is ","path":"docs/core-concepts/core-sdk/cli/overview.md","position":44,"original_position":44,"commit_id":"fe9994efb1240093c1c6739aa941a87d48f82217","original_commit_id":"fe9994efb1240093c1c6739aa941a87d48f82217","user":{"login":"mairaw","id":12971179,"avatar_url":"https://avatars.githubusercontent.com/u/12971179?v=3","gravatar_id":"","url":"https://api.github.com/users/mairaw","html_url":"https://github.com/mairaw","followers_url":"https://api.github.com/users/mairaw/followers","following_url":"https://api.github.com/users/mairaw/following{/other_user}","gists_url":"https://api.github.com/users/mairaw/gists{/gist_id}","starred_url":"https://api.github.com/users/mairaw/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mairaw/subscriptions","organizations_url":"https://api.github.com/users/mairaw/orgs","repos_url":"https://api.github.com/users/mairaw/repos","events_url":"https://api.github.com/users/mairaw/events{/privacy}","received_events_url":"https://api.github.com/users/mairaw/received_events","type":"User","site_admin":false},"body":"I'd remove the of course from here since this is not an obvious information:\r\nOf course, there is a way -> There is also a way\r\nto add your commands -> to add your own commands","created_at":"2016-05-02T22:15:38Z","updated_at":"2016-05-02T22:15:38Z","html_url":"https://github.com/dotnet/core-docs/pull/391#discussion_r61814307","pull_request_url":"https://api.github.com/repos/dotnet/core-docs/pulls/391","_links":{"self":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/comments/61814307"},"html":{"href":"https://github.com/dotnet/core-docs/pull/391#discussion_r61814307"},"pull_request":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/391"}}},"pull_request":{"url":"https://api.github.com/repos/dotnet/core-docs/pulls/391","id":64821312,"html_url":"https://github.com/dotnet/core-docs/pull/391","diff_url":"https://github.com/dotnet/core-docs/pull/391.diff","patch_url":"https://github.com/dotnet/core-docs/pull/391.patch","issue_url":"https://api.github.com/repos/dotnet/core-docs/issues/391","number":391,"state":"open","locked":false,"title":"Add CLI documentation","user":{"login":"blackdwarf","id":3115004,"avatar_url":"https://avatars.githubusercontent.com/u/3115004?v=3","gravatar_id":"","url":"https://api.github.com/users/blackdwarf","html_url":"https://github.com/blackdwarf","followers_url":"https://api.github.com/users/blackdwarf/followers","following_url":"https://api.github.com/users/blackdwarf/following{/other_user}","gists_url":"https://api.github.com/users/blackdwarf/gists{/gist_id}","starred_url":"https://api.github.com/users/blackdwarf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/blackdwarf/subscriptions","organizations_url":"https://api.github.com/users/blackdwarf/orgs","repos_url":"https://api.github.com/users/blackdwarf/repos","events_url":"https://api.github.com/users/blackdwarf/events{/privacy}","received_events_url":"https://api.github.com/users/blackdwarf/received_events","type":"User","site_admin":false},"body":"Added documentation for the CLI. It contains two main groups of\r\ndocuments:\r\n\r\n1. Conceptual docs - docs that deal with how the CLI works, what the\r\nare the portability types of applications and the overview.\r\n2. Reference docs - command line reference docs for each command as\r\nwell as the install script.\r\n\r\nAnother document is the DNX -> CLI migration document that is part of\r\nthis change.\r\n\r\nFixes #391 \r\nRelates to #322 \r\n\r\n/cc @mairaw @danroth27 @cartermp @richlander ","created_at":"2016-03-31T16:41:59Z","updated_at":"2016-05-02T22:15:38Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1a89f65aa6fef9853c7eb8bcec146a53afff380e","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/dotnet/core-docs/pulls/391/commits","review_comments_url":"https://api.github.com/repos/dotnet/core-docs/pulls/391/comments","review_comment_url":"https://api.github.com/repos/dotnet/core-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/dotnet/core-docs/issues/391/comments","statuses_url":"https://api.github.com/repos/dotnet/core-docs/statuses/fe9994efb1240093c1c6739aa941a87d48f82217","head":{"label":"blackdwarf:clidocs","ref":"clidocs","sha":"fe9994efb1240093c1c6739aa941a87d48f82217","user":{"login":"blackdwarf","id":3115004,"avatar_url":"https://avatars.githubusercontent.com/u/3115004?v=3","gravatar_id":"","url":"https://api.github.com/users/blackdwarf","html_url":"https://github.com/blackdwarf","followers_url":"https://api.github.com/users/blackdwarf/followers","following_url":"https://api.github.com/users/blackdwarf/following{/other_user}","gists_url":"https://api.github.com/users/blackdwarf/gists{/gist_id}","starred_url":"https://api.github.com/users/blackdwarf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/blackdwarf/subscriptions","organizations_url":"https://api.github.com/users/blackdwarf/orgs","repos_url":"https://api.github.com/users/blackdwarf/repos","events_url":"https://api.github.com/users/blackdwarf/events{/privacy}","received_events_url":"https://api.github.com/users/blackdwarf/received_events","type":"User","site_admin":false},"repo":{"id":35895436,"name":"core-docs","full_name":"blackdwarf/core-docs","owner":{"login":"blackdwarf","id":3115004,"avatar_url":"https://avatars.githubusercontent.com/u/3115004?v=3","gravatar_id":"","url":"https://api.github.com/users/blackdwarf","html_url":"https://github.com/blackdwarf","followers_url":"https://api.github.com/users/blackdwarf/followers","following_url":"https://api.github.com/users/blackdwarf/following{/other_user}","gists_url":"https://api.github.com/users/blackdwarf/gists{/gist_id}","starred_url":"https://api.github.com/users/blackdwarf/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/blackdwarf/subscriptions","organizations_url":"https://api.github.com/users/blackdwarf/orgs","repos_url":"https://api.github.com/users/blackdwarf/repos","events_url":"https://api.github.com/users/blackdwarf/events{/privacy}","received_events_url":"https://api.github.com/users/blackdwarf/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/blackdwarf/core-docs","description":"Experimenting with docs.","fork":true,"url":"https://api.github.com/repos/blackdwarf/core-docs","forks_url":"https://api.github.com/repos/blackdwarf/core-docs/forks","keys_url":"https://api.github.com/repos/blackdwarf/core-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/blackdwarf/core-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/blackdwarf/core-docs/teams","hooks_url":"https://api.github.com/repos/blackdwarf/core-docs/hooks","issue_events_url":"https://api.github.com/repos/blackdwarf/core-docs/issues/events{/number}","events_url":"https://api.github.com/repos/blackdwarf/core-docs/events","assignees_url":"https://api.github.com/repos/blackdwarf/core-docs/assignees{/user}","branches_url":"https://api.github.com/repos/blackdwarf/core-docs/branches{/branch}","tags_url":"https://api.github.com/repos/blackdwarf/core-docs/tags","blobs_url":"https://api.github.com/repos/blackdwarf/core-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/blackdwarf/core-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/blackdwarf/core-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/blackdwarf/core-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/blackdwarf/core-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/blackdwarf/core-docs/languages","stargazers_url":"https://api.github.com/repos/blackdwarf/core-docs/stargazers","contributors_url":"https://api.github.com/repos/blackdwarf/core-docs/contributors","subscribers_url":"https://api.github.com/repos/blackdwarf/core-docs/subscribers","subscription_url":"https://api.github.com/repos/blackdwarf/core-docs/subscription","commits_url":"https://api.github.com/repos/blackdwarf/core-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/blackdwarf/core-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/blackdwarf/core-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/blackdwarf/core-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/blackdwarf/core-docs/contents/{+path}","compare_url":"https://api.github.com/repos/blackdwarf/core-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/blackdwarf/core-docs/merges","archive_url":"https://api.github.com/repos/blackdwarf/core-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/blackdwarf/core-docs/downloads","issues_url":"https://api.github.com/repos/blackdwarf/core-docs/issues{/number}","pulls_url":"https://api.github.com/repos/blackdwarf/core-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/blackdwarf/core-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/blackdwarf/core-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/blackdwarf/core-docs/labels{/name}","releases_url":"https://api.github.com/repos/blackdwarf/core-docs/releases{/id}","deployments_url":"https://api.github.com/repos/blackdwarf/core-docs/deployments","created_at":"2015-05-19T16:47:30Z","updated_at":"2016-01-11T18:26:56Z","pushed_at":"2016-05-02T20:11:55Z","git_url":"git://github.com/blackdwarf/core-docs.git","ssh_url":"git@github.com:blackdwarf/core-docs.git","clone_url":"https://github.com/blackdwarf/core-docs.git","svn_url":"https://github.com/blackdwarf/core-docs","homepage":null,"size":10397,"stargazers_count":0,"watchers_count":0,"language":"CSS","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":2,"mirror_url":null,"open_issues_count":1,"forks":2,"open_issues":1,"watchers":0,"default_branch":"master"}},"base":{"label":"dotnet:master","ref":"master","sha":"157504029d8a6742a4882e57e1e0ab9220d00894","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":35890081,"name":"core-docs","full_name":"dotnet/core-docs","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/core-docs","description":".NET Core documentation (work in progress).","fork":false,"url":"https://api.github.com/repos/dotnet/core-docs","forks_url":"https://api.github.com/repos/dotnet/core-docs/forks","keys_url":"https://api.github.com/repos/dotnet/core-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/dotnet/core-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/dotnet/core-docs/teams","hooks_url":"https://api.github.com/repos/dotnet/core-docs/hooks","issue_events_url":"https://api.github.com/repos/dotnet/core-docs/issues/events{/number}","events_url":"https://api.github.com/repos/dotnet/core-docs/events","assignees_url":"https://api.github.com/repos/dotnet/core-docs/assignees{/user}","branches_url":"https://api.github.com/repos/dotnet/core-docs/branches{/branch}","tags_url":"https://api.github.com/repos/dotnet/core-docs/tags","blobs_url":"https://api.github.com/repos/dotnet/core-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/dotnet/core-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/dotnet/core-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/dotnet/core-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/dotnet/core-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/dotnet/core-docs/languages","stargazers_url":"https://api.github.com/repos/dotnet/core-docs/stargazers","contributors_url":"https://api.github.com/repos/dotnet/core-docs/contributors","subscribers_url":"https://api.github.com/repos/dotnet/core-docs/subscribers","subscription_url":"https://api.github.com/repos/dotnet/core-docs/subscription","commits_url":"https://api.github.com/repos/dotnet/core-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/dotnet/core-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/dotnet/core-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/dotnet/core-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/dotnet/core-docs/contents/{+path}","compare_url":"https://api.github.com/repos/dotnet/core-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/dotnet/core-docs/merges","archive_url":"https://api.github.com/repos/dotnet/core-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/dotnet/core-docs/downloads","issues_url":"https://api.github.com/repos/dotnet/core-docs/issues{/number}","pulls_url":"https://api.github.com/repos/dotnet/core-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/dotnet/core-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/dotnet/core-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/dotnet/core-docs/labels{/name}","releases_url":"https://api.github.com/repos/dotnet/core-docs/releases{/id}","deployments_url":"https://api.github.com/repos/dotnet/core-docs/deployments","created_at":"2015-05-19T15:13:32Z","updated_at":"2016-04-29T10:55:15Z","pushed_at":"2016-05-02T20:11:56Z","git_url":"git://github.com/dotnet/core-docs.git","ssh_url":"git@github.com:dotnet/core-docs.git","clone_url":"https://github.com/dotnet/core-docs.git","svn_url":"https://github.com/dotnet/core-docs","homepage":"http://dotnet.github.io/docs/index.html","size":14380,"stargazers_count":81,"watchers_count":81,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":88,"mirror_url":null,"open_issues_count":131,"forks":88,"open_issues":131,"watchers":81,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/391"},"html":{"href":"https://github.com/dotnet/core-docs/pull/391"},"issue":{"href":"https://api.github.com/repos/dotnet/core-docs/issues/391"},"comments":{"href":"https://api.github.com/repos/dotnet/core-docs/issues/391/comments"},"review_comments":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/391/comments"},"review_comment":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/dotnet/core-docs/pulls/391/commits"},"statuses":{"href":"https://api.github.com/repos/dotnet/core-docs/statuses/fe9994efb1240093c1c6739aa941a87d48f82217"}}}}