{"action":"created","comment":{"url":"https://api.github.com/repos/jupyter/jupyter/pulls/comments/50429840","id":50429840,"diff_hunk":"@@ -1,97 +1,94 @@\n .. _install:\n \n-\n ============\n Installation\n ============\n \n-These installation instructions explain how to install the Jupyter Notebook and\n-the IPython kernel.\n-\n-While Jupyter allows users to run code in many different\n-programming languages, the Jupyter Notebook itself is implemented in Python.\n-To install Jupyter Notebook, you will also need Python installed on your system.\n+This section explains how to install the Jupyter Notebook and the IPython\n+kernel.\n \n-**Installation Scenarios**\n+While Jupyter runs code in many different programming languages, Python is a\n+prerequisite for installing Jupyter notebook. Select one of the scenarios to\n+install Jupyter:\n \n-* :ref:`New user: New to Python and Jupyter <new-to-python-and-jupyter>`\n-* :ref:`Experienced Python user: New to Jupyter <existing-python-new-jupyter>`\n-* :ref:`Upgrading Jupyter <upgrading>`\n+    - :ref:`Jupyter (new to Python) <new-to-python-and-jupyter>`\n+    - :ref:`Jupyter (experience with Python) <existing-python-new-jupyter>`\n+    - :ref:`Upgrading a Jupyter installation <upgrading>`\n \n .. note::\n \n-     All commands shown below must be run in the Terminal (Mac/Linux) or Command\n-     Prompt (Windows)\n+     All installation commands should be run in the Terminal (for Mac and Linux)\n+     or the Command Prompt (Windows).\n \n .. _new-to-python-and-jupyter:\n \n-New Users: New to Python and Jupyter\n-------------------------------------\n+Jupyter (new to Python)\n+-----------------------\n \n-If you're new to Python, we highly recommend `installing Anaconda\n-<https://www.continuum.io/downloads>`_. Anaconda includes and conveniently\n+For new users, we **highly recommend** `installing Anaconda\n+<https://www.continuum.io/downloads>`_. Anaconda conveniently\n installs Python, the Jupyter Notebook, and other commonly used packages for\n scientific computing and data science. Follow Anaconda's instructions for\n-downloading the Python 3.5 version.\n+downloading and installing the Python 3.5 version.\n \n-After you have Anaconda installed, you should make sure that Jupyter is up to\n-date. Run the following command in the Terminal (Mac/Linux) or Command\n-Prompt (Windows)::\n+After installing Anaconda, run the following command in the Terminal or the\n+Command Prompt to install Jupyter::\n \n     conda install jupyter\n \n-Alternatively, you may also use the Anaconda Launcher application to update to\n-the latest version.\n-\n-Now, you may consider :ref:`installing additional kernels <installing-kernels>`\n-and :ref:`next steps <next-steps>` such as running the Jupyter Notebook.\n+Alternatively, use the Anaconda Launcher application to update to the latest\n+Jupyter version.\n \n+See :ref:`installing additional kernels <installing-kernels>` to use programming\n+languages other than Python and :ref:`next steps <next-steps>` for running the\n+Jupyter Notebook.","path":"docs/source/install.rst","position":70,"original_position":70,"commit_id":"d7c5acc530d782c0d50d5079988b50dad5429356","original_commit_id":"d7c5acc530d782c0d50d5079988b50dad5429356","user":{"login":"takluyver","id":327925,"avatar_url":"https://avatars.githubusercontent.com/u/327925?v=3","gravatar_id":"","url":"https://api.github.com/users/takluyver","html_url":"https://github.com/takluyver","followers_url":"https://api.github.com/users/takluyver/followers","following_url":"https://api.github.com/users/takluyver/following{/other_user}","gists_url":"https://api.github.com/users/takluyver/gists{/gist_id}","starred_url":"https://api.github.com/users/takluyver/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/takluyver/subscriptions","organizations_url":"https://api.github.com/users/takluyver/orgs","repos_url":"https://api.github.com/users/takluyver/repos","events_url":"https://api.github.com/users/takluyver/events{/privacy}","received_events_url":"https://api.github.com/users/takluyver/received_events","type":"User","site_admin":false},"body":"Should we switch these two round? I would point people to running it as the default next step.","created_at":"2016-01-21T17:04:32Z","updated_at":"2016-01-21T17:04:32Z","html_url":"https://github.com/jupyter/jupyter/pull/99#discussion_r50429840","pull_request_url":"https://api.github.com/repos/jupyter/jupyter/pulls/99","_links":{"self":{"href":"https://api.github.com/repos/jupyter/jupyter/pulls/comments/50429840"},"html":{"href":"https://github.com/jupyter/jupyter/pull/99#discussion_r50429840"},"pull_request":{"href":"https://api.github.com/repos/jupyter/jupyter/pulls/99"}}},"pull_request":{"url":"https://api.github.com/repos/jupyter/jupyter/pulls/99","id":56765603,"html_url":"https://github.com/jupyter/jupyter/pull/99","diff_url":"https://github.com/jupyter/jupyter/pull/99.diff","patch_url":"https://github.com/jupyter/jupyter/pull/99.patch","issue_url":"https://api.github.com/repos/jupyter/jupyter/issues/99","number":99,"state":"open","locked":false,"title":"Edit installation doc","user":{"login":"willingc","id":2680980,"avatar_url":"https://avatars.githubusercontent.com/u/2680980?v=3","gravatar_id":"","url":"https://api.github.com/users/willingc","html_url":"https://github.com/willingc","followers_url":"https://api.github.com/users/willingc/followers","following_url":"https://api.github.com/users/willingc/following{/other_user}","gists_url":"https://api.github.com/users/willingc/gists{/gist_id}","starred_url":"https://api.github.com/users/willingc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/willingc/subscriptions","organizations_url":"https://api.github.com/users/willingc/orgs","repos_url":"https://api.github.com/users/willingc/repos","events_url":"https://api.github.com/users/willingc/events{/privacy}","received_events_url":"https://api.github.com/users/willingc/received_events","type":"User","site_admin":false},"body":"This PR follows the changes made in #98. The edits here strive for more concise text and improving end user clarity.\r\n\r\n@takluyver Would you mind reviewing?","created_at":"2016-01-21T15:37:36Z","updated_at":"2016-01-21T17:04:32Z","closed_at":null,"merged_at":null,"merge_commit_sha":"437ab899e8d2601d13e30f09441f5471c33ee7bc","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/jupyter/jupyter/pulls/99/commits","review_comments_url":"https://api.github.com/repos/jupyter/jupyter/pulls/99/comments","review_comment_url":"https://api.github.com/repos/jupyter/jupyter/pulls/comments{/number}","comments_url":"https://api.github.com/repos/jupyter/jupyter/issues/99/comments","statuses_url":"https://api.github.com/repos/jupyter/jupyter/statuses/d7c5acc530d782c0d50d5079988b50dad5429356","head":{"label":"willingc:doc-editinstall","ref":"doc-editinstall","sha":"d7c5acc530d782c0d50d5079988b50dad5429356","user":{"login":"willingc","id":2680980,"avatar_url":"https://avatars.githubusercontent.com/u/2680980?v=3","gravatar_id":"","url":"https://api.github.com/users/willingc","html_url":"https://github.com/willingc","followers_url":"https://api.github.com/users/willingc/followers","following_url":"https://api.github.com/users/willingc/following{/other_user}","gists_url":"https://api.github.com/users/willingc/gists{/gist_id}","starred_url":"https://api.github.com/users/willingc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/willingc/subscriptions","organizations_url":"https://api.github.com/users/willingc/orgs","repos_url":"https://api.github.com/users/willingc/repos","events_url":"https://api.github.com/users/willingc/events{/privacy}","received_events_url":"https://api.github.com/users/willingc/received_events","type":"User","site_admin":false},"repo":{"id":41396092,"name":"jupyter","full_name":"willingc/jupyter","owner":{"login":"willingc","id":2680980,"avatar_url":"https://avatars.githubusercontent.com/u/2680980?v=3","gravatar_id":"","url":"https://api.github.com/users/willingc","html_url":"https://github.com/willingc","followers_url":"https://api.github.com/users/willingc/followers","following_url":"https://api.github.com/users/willingc/following{/other_user}","gists_url":"https://api.github.com/users/willingc/gists{/gist_id}","starred_url":"https://api.github.com/users/willingc/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/willingc/subscriptions","organizations_url":"https://api.github.com/users/willingc/orgs","repos_url":"https://api.github.com/users/willingc/repos","events_url":"https://api.github.com/users/willingc/events{/privacy}","received_events_url":"https://api.github.com/users/willingc/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/willingc/jupyter","description":"Jupyter metapackage for installation, docs and chat","fork":true,"url":"https://api.github.com/repos/willingc/jupyter","forks_url":"https://api.github.com/repos/willingc/jupyter/forks","keys_url":"https://api.github.com/repos/willingc/jupyter/keys{/key_id}","collaborators_url":"https://api.github.com/repos/willingc/jupyter/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/willingc/jupyter/teams","hooks_url":"https://api.github.com/repos/willingc/jupyter/hooks","issue_events_url":"https://api.github.com/repos/willingc/jupyter/issues/events{/number}","events_url":"https://api.github.com/repos/willingc/jupyter/events","assignees_url":"https://api.github.com/repos/willingc/jupyter/assignees{/user}","branches_url":"https://api.github.com/repos/willingc/jupyter/branches{/branch}","tags_url":"https://api.github.com/repos/willingc/jupyter/tags","blobs_url":"https://api.github.com/repos/willingc/jupyter/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/willingc/jupyter/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/willingc/jupyter/git/refs{/sha}","trees_url":"https://api.github.com/repos/willingc/jupyter/git/trees{/sha}","statuses_url":"https://api.github.com/repos/willingc/jupyter/statuses/{sha}","languages_url":"https://api.github.com/repos/willingc/jupyter/languages","stargazers_url":"https://api.github.com/repos/willingc/jupyter/stargazers","contributors_url":"https://api.github.com/repos/willingc/jupyter/contributors","subscribers_url":"https://api.github.com/repos/willingc/jupyter/subscribers","subscription_url":"https://api.github.com/repos/willingc/jupyter/subscription","commits_url":"https://api.github.com/repos/willingc/jupyter/commits{/sha}","git_commits_url":"https://api.github.com/repos/willingc/jupyter/git/commits{/sha}","comments_url":"https://api.github.com/repos/willingc/jupyter/comments{/number}","issue_comment_url":"https://api.github.com/repos/willingc/jupyter/issues/comments{/number}","contents_url":"https://api.github.com/repos/willingc/jupyter/contents/{+path}","compare_url":"https://api.github.com/repos/willingc/jupyter/compare/{base}...{head}","merges_url":"https://api.github.com/repos/willingc/jupyter/merges","archive_url":"https://api.github.com/repos/willingc/jupyter/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/willingc/jupyter/downloads","issues_url":"https://api.github.com/repos/willingc/jupyter/issues{/number}","pulls_url":"https://api.github.com/repos/willingc/jupyter/pulls{/number}","milestones_url":"https://api.github.com/repos/willingc/jupyter/milestones{/number}","notifications_url":"https://api.github.com/repos/willingc/jupyter/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/willingc/jupyter/labels{/name}","releases_url":"https://api.github.com/repos/willingc/jupyter/releases{/id}","created_at":"2015-08-26T00:59:33Z","updated_at":"2016-01-21T14:18:34Z","pushed_at":"2016-01-21T15:33:23Z","git_url":"git://github.com/willingc/jupyter.git","ssh_url":"git@github.com:willingc/jupyter.git","clone_url":"https://github.com/willingc/jupyter.git","svn_url":"https://github.com/willingc/jupyter","homepage":"http://jupyter.readthedocs.org/","size":251,"stargazers_count":0,"watchers_count":0,"language":"Python","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":"jupyter:master","ref":"master","sha":"c4c60bbadefde99de1073c026bfeeed26ca6e20f","user":{"login":"jupyter","id":7388996,"avatar_url":"https://avatars.githubusercontent.com/u/7388996?v=3","gravatar_id":"","url":"https://api.github.com/users/jupyter","html_url":"https://github.com/jupyter","followers_url":"https://api.github.com/users/jupyter/followers","following_url":"https://api.github.com/users/jupyter/following{/other_user}","gists_url":"https://api.github.com/users/jupyter/gists{/gist_id}","starred_url":"https://api.github.com/users/jupyter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jupyter/subscriptions","organizations_url":"https://api.github.com/users/jupyter/orgs","repos_url":"https://api.github.com/users/jupyter/repos","events_url":"https://api.github.com/users/jupyter/events{/privacy}","received_events_url":"https://api.github.com/users/jupyter/received_events","type":"Organization","site_admin":false},"repo":{"id":36895421,"name":"jupyter","full_name":"jupyter/jupyter","owner":{"login":"jupyter","id":7388996,"avatar_url":"https://avatars.githubusercontent.com/u/7388996?v=3","gravatar_id":"","url":"https://api.github.com/users/jupyter","html_url":"https://github.com/jupyter","followers_url":"https://api.github.com/users/jupyter/followers","following_url":"https://api.github.com/users/jupyter/following{/other_user}","gists_url":"https://api.github.com/users/jupyter/gists{/gist_id}","starred_url":"https://api.github.com/users/jupyter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jupyter/subscriptions","organizations_url":"https://api.github.com/users/jupyter/orgs","repos_url":"https://api.github.com/users/jupyter/repos","events_url":"https://api.github.com/users/jupyter/events{/privacy}","received_events_url":"https://api.github.com/users/jupyter/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/jupyter/jupyter","description":"Jupyter metapackage for installation, docs and chat","fork":false,"url":"https://api.github.com/repos/jupyter/jupyter","forks_url":"https://api.github.com/repos/jupyter/jupyter/forks","keys_url":"https://api.github.com/repos/jupyter/jupyter/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jupyter/jupyter/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jupyter/jupyter/teams","hooks_url":"https://api.github.com/repos/jupyter/jupyter/hooks","issue_events_url":"https://api.github.com/repos/jupyter/jupyter/issues/events{/number}","events_url":"https://api.github.com/repos/jupyter/jupyter/events","assignees_url":"https://api.github.com/repos/jupyter/jupyter/assignees{/user}","branches_url":"https://api.github.com/repos/jupyter/jupyter/branches{/branch}","tags_url":"https://api.github.com/repos/jupyter/jupyter/tags","blobs_url":"https://api.github.com/repos/jupyter/jupyter/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jupyter/jupyter/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jupyter/jupyter/git/refs{/sha}","trees_url":"https://api.github.com/repos/jupyter/jupyter/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jupyter/jupyter/statuses/{sha}","languages_url":"https://api.github.com/repos/jupyter/jupyter/languages","stargazers_url":"https://api.github.com/repos/jupyter/jupyter/stargazers","contributors_url":"https://api.github.com/repos/jupyter/jupyter/contributors","subscribers_url":"https://api.github.com/repos/jupyter/jupyter/subscribers","subscription_url":"https://api.github.com/repos/jupyter/jupyter/subscription","commits_url":"https://api.github.com/repos/jupyter/jupyter/commits{/sha}","git_commits_url":"https://api.github.com/repos/jupyter/jupyter/git/commits{/sha}","comments_url":"https://api.github.com/repos/jupyter/jupyter/comments{/number}","issue_comment_url":"https://api.github.com/repos/jupyter/jupyter/issues/comments{/number}","contents_url":"https://api.github.com/repos/jupyter/jupyter/contents/{+path}","compare_url":"https://api.github.com/repos/jupyter/jupyter/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jupyter/jupyter/merges","archive_url":"https://api.github.com/repos/jupyter/jupyter/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jupyter/jupyter/downloads","issues_url":"https://api.github.com/repos/jupyter/jupyter/issues{/number}","pulls_url":"https://api.github.com/repos/jupyter/jupyter/pulls{/number}","milestones_url":"https://api.github.com/repos/jupyter/jupyter/milestones{/number}","notifications_url":"https://api.github.com/repos/jupyter/jupyter/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jupyter/jupyter/labels{/name}","releases_url":"https://api.github.com/repos/jupyter/jupyter/releases{/id}","created_at":"2015-06-04T21:05:00Z","updated_at":"2016-01-21T04:54:45Z","pushed_at":"2016-01-21T15:37:36Z","git_url":"git://github.com/jupyter/jupyter.git","ssh_url":"git@github.com:jupyter/jupyter.git","clone_url":"https://github.com/jupyter/jupyter.git","svn_url":"https://github.com/jupyter/jupyter","homepage":"http://jupyter.readthedocs.org/","size":249,"stargazers_count":118,"watchers_count":118,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":61,"mirror_url":null,"open_issues_count":26,"forks":61,"open_issues":26,"watchers":118,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/jupyter/jupyter/pulls/99"},"html":{"href":"https://github.com/jupyter/jupyter/pull/99"},"issue":{"href":"https://api.github.com/repos/jupyter/jupyter/issues/99"},"comments":{"href":"https://api.github.com/repos/jupyter/jupyter/issues/99/comments"},"review_comments":{"href":"https://api.github.com/repos/jupyter/jupyter/pulls/99/comments"},"review_comment":{"href":"https://api.github.com/repos/jupyter/jupyter/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/jupyter/jupyter/pulls/99/commits"},"statuses":{"href":"https://api.github.com/repos/jupyter/jupyter/statuses/d7c5acc530d782c0d50d5079988b50dad5429356"}}}}