{"action":"created","comment":{"url":"https://api.github.com/repos/juju/docs/pulls/comments/32524152","id":32524152,"diff_hunk":"@@ -49,52 +57,40 @@ particular cloud provider. This is done by generating and editing the following\n ## Windows\n     %LOCALAPPDATA%/Juju\n     \n-You can generate the environments file manually, but Juju also includes a \n-boilerplate configuration option that will flesh out most of the file for \n-you and minimise the amount of work (and potential errors).\n-\n-To generate an initial config file, you simply need to run:\n-\n-    juju generate-config\n+Juju can automatically generate this file in this way:\n \n-This command will cause a file to be written to your ~/.juju directory if an\n-environments.yaml file does not already exist. It will also create the ~./juju\n-directory if that does not exist.\n-\n-This file will contain sample profiles for different types of cloud services,\n-but you will need to edit the files to provide specific information for your\n-cloud provider. Sections are created for Amazon (AWS) services, HPCloud and a\n-generic OpenStack instance (and for the local provider if running on Linux). For\n-more specifics on what needs to be changed, see the relevant sections below.\n+```bash\n+juju generate-config\n+```\n \n-  - [Configuring for Amazon AWS](config-aws.html)\n-  - [Configuring for Windows Azure](config-azure.html)\n-  - [Configuring for HP Cloud](config-hpcloud.html)\n-  - [Configuring for OpenStack](config-openstack.html)\n-  - [Configuring for bare metal using MAAS](config-maas.html)\n-  - [Configuring for LXC local provider (Linux)](config-local.html)\n-  - [Configuring for Vagrant local provider (OSX, Linux, and Windows)](config-vagrant.html)\n+This action will not overwrite an existing file but merely dump the information\n+onscreen (STDOUT). It will contain sample profiles for different types of cloud\n+services.  Edit it to provide specific information for your chosen cloud\n+provider. For more specifics on what needs to be changed, see the relevant\n+sections in the left pane (under *Install & Configure*).\n \n-**Note:** Juju's command line interface includes documentation, doing `juju help` will show you the topics. You can also check out the [Juju command cheatsheet](https://github.com/juju/cheatsheet) if you are looking for a handy command guide.\n+**Note:** Juju's command line interface includes documentation, doing `juju\n+help` will show you the topics. You can also look at the [Juju command\n+cheatsheet](https://github.com/juju/cheatsheet) if you are looking for a handy\n+command guide.\n \n # Testing your setup\n \n-Once you have installed and configured Juju, it is probably a good idea to take\n-it for a bit of a test drive and check that everything is working as expected.\n-Because Juju makes it really easy to deploy services, this is actually quick and\n-straightforward.\n-\n-The first thing to do is set up a bootstrap environment. This is an instance in\n-the cloud that Juju will use to deploy and control other services with. It will\n-be created according to the configuration you have provided, and your SSH key\n-will automatically be uploaded so that Juju can communicate securely with the\n-bootstrap instance.\n+The first step is to create a bootstrap environment. This is a cloud instance\n+that Juju will use to deploy and manage services. It will be created according\n+to the configuration you have provided, and your SSH key will automatically be\n+injected so that Juju can communicate securely with the bootstrap instance.","path":"src/en/getting-started.md","position":124,"original_position":124,"commit_id":"54548fcb6fa7b88a4871dc71f9fa3716e4c83f90","original_commit_id":"54548fcb6fa7b88a4871dc71f9fa3716e4c83f90","user":{"login":"petermatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/petermatulis","html_url":"https://github.com/petermatulis","followers_url":"https://api.github.com/users/petermatulis/followers","following_url":"https://api.github.com/users/petermatulis/following{/other_user}","gists_url":"https://api.github.com/users/petermatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/petermatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/petermatulis/subscriptions","organizations_url":"https://api.github.com/users/petermatulis/orgs","repos_url":"https://api.github.com/users/petermatulis/repos","events_url":"https://api.github.com/users/petermatulis/events{/privacy}","received_events_url":"https://api.github.com/users/petermatulis/received_events","type":"User","site_admin":false},"body":"What about changing the name of this file from \"getting-started.md\" to \"install-configure.md\"? The title in the TOC (left pane) shows \"Install & Configure\".\r\n\r\nThere is an entry in the TOC that is called \"Getting started\" whose corresponding filename is \"authors-intro.md\".","created_at":"2015-06-16T14:11:14Z","updated_at":"2015-06-16T14:11:14Z","html_url":"https://github.com/juju/docs/pull/476#discussion_r32524152","pull_request_url":"https://api.github.com/repos/juju/docs/pulls/476","_links":{"self":{"href":"https://api.github.com/repos/juju/docs/pulls/comments/32524152"},"html":{"href":"https://github.com/juju/docs/pull/476#discussion_r32524152"},"pull_request":{"href":"https://api.github.com/repos/juju/docs/pulls/476"}}},"pull_request":{"url":"https://api.github.com/repos/juju/docs/pulls/476","id":37595387,"html_url":"https://github.com/juju/docs/pull/476","diff_url":"https://github.com/juju/docs/pull/476.diff","patch_url":"https://github.com/juju/docs/pull/476.patch","issue_url":"https://api.github.com/repos/juju/docs/issues/476","number":476,"state":"open","locked":false,"title":"code fencing + general review: src/en/g_files.md","user":{"login":"petermatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/petermatulis","html_url":"https://github.com/petermatulis","followers_url":"https://api.github.com/users/petermatulis/followers","following_url":"https://api.github.com/users/petermatulis/following{/other_user}","gists_url":"https://api.github.com/users/petermatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/petermatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/petermatulis/subscriptions","organizations_url":"https://api.github.com/users/petermatulis/orgs","repos_url":"https://api.github.com/users/petermatulis/repos","events_url":"https://api.github.com/users/petermatulis/events{/privacy}","received_events_url":"https://api.github.com/users/petermatulis/received_events","type":"User","site_admin":false},"body":"More code/output fencing and general review of\r\n\r\nsrc/en/g*.md\r\n\r\n#444 updated","created_at":"2015-06-12T19:17:00Z","updated_at":"2015-06-16T14:11:14Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5c7ac50da14d4c3cdd16948a5aa57a57d9b58116","assignee":{"login":"evilnick","id":115290,"avatar_url":"https://avatars.githubusercontent.com/u/115290?v=3","gravatar_id":"","url":"https://api.github.com/users/evilnick","html_url":"https://github.com/evilnick","followers_url":"https://api.github.com/users/evilnick/followers","following_url":"https://api.github.com/users/evilnick/following{/other_user}","gists_url":"https://api.github.com/users/evilnick/gists{/gist_id}","starred_url":"https://api.github.com/users/evilnick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/evilnick/subscriptions","organizations_url":"https://api.github.com/users/evilnick/orgs","repos_url":"https://api.github.com/users/evilnick/repos","events_url":"https://api.github.com/users/evilnick/events{/privacy}","received_events_url":"https://api.github.com/users/evilnick/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/juju/docs/pulls/476/commits","review_comments_url":"https://api.github.com/repos/juju/docs/pulls/476/comments","review_comment_url":"https://api.github.com/repos/juju/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/juju/docs/issues/476/comments","statuses_url":"https://api.github.com/repos/juju/docs/statuses/54548fcb6fa7b88a4871dc71f9fa3716e4c83f90","head":{"label":"petermatulis:code_fencing-g_files.md","ref":"code_fencing-g_files.md","sha":"54548fcb6fa7b88a4871dc71f9fa3716e4c83f90","user":{"login":"petermatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/petermatulis","html_url":"https://github.com/petermatulis","followers_url":"https://api.github.com/users/petermatulis/followers","following_url":"https://api.github.com/users/petermatulis/following{/other_user}","gists_url":"https://api.github.com/users/petermatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/petermatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/petermatulis/subscriptions","organizations_url":"https://api.github.com/users/petermatulis/orgs","repos_url":"https://api.github.com/users/petermatulis/repos","events_url":"https://api.github.com/users/petermatulis/events{/privacy}","received_events_url":"https://api.github.com/users/petermatulis/received_events","type":"User","site_admin":false},"repo":{"id":36665444,"name":"docs","full_name":"petermatulis/docs","owner":{"login":"petermatulis","id":6303808,"avatar_url":"https://avatars.githubusercontent.com/u/6303808?v=3","gravatar_id":"","url":"https://api.github.com/users/petermatulis","html_url":"https://github.com/petermatulis","followers_url":"https://api.github.com/users/petermatulis/followers","following_url":"https://api.github.com/users/petermatulis/following{/other_user}","gists_url":"https://api.github.com/users/petermatulis/gists{/gist_id}","starred_url":"https://api.github.com/users/petermatulis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/petermatulis/subscriptions","organizations_url":"https://api.github.com/users/petermatulis/orgs","repos_url":"https://api.github.com/users/petermatulis/repos","events_url":"https://api.github.com/users/petermatulis/events{/privacy}","received_events_url":"https://api.github.com/users/petermatulis/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/petermatulis/docs","description":"Juju documentation, found online at https://jujucharms.com/docs","fork":true,"url":"https://api.github.com/repos/petermatulis/docs","forks_url":"https://api.github.com/repos/petermatulis/docs/forks","keys_url":"https://api.github.com/repos/petermatulis/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/petermatulis/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/petermatulis/docs/teams","hooks_url":"https://api.github.com/repos/petermatulis/docs/hooks","issue_events_url":"https://api.github.com/repos/petermatulis/docs/issues/events{/number}","events_url":"https://api.github.com/repos/petermatulis/docs/events","assignees_url":"https://api.github.com/repos/petermatulis/docs/assignees{/user}","branches_url":"https://api.github.com/repos/petermatulis/docs/branches{/branch}","tags_url":"https://api.github.com/repos/petermatulis/docs/tags","blobs_url":"https://api.github.com/repos/petermatulis/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/petermatulis/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/petermatulis/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/petermatulis/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/petermatulis/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/petermatulis/docs/languages","stargazers_url":"https://api.github.com/repos/petermatulis/docs/stargazers","contributors_url":"https://api.github.com/repos/petermatulis/docs/contributors","subscribers_url":"https://api.github.com/repos/petermatulis/docs/subscribers","subscription_url":"https://api.github.com/repos/petermatulis/docs/subscription","commits_url":"https://api.github.com/repos/petermatulis/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/petermatulis/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/petermatulis/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/petermatulis/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/petermatulis/docs/contents/{+path}","compare_url":"https://api.github.com/repos/petermatulis/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/petermatulis/docs/merges","archive_url":"https://api.github.com/repos/petermatulis/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/petermatulis/docs/downloads","issues_url":"https://api.github.com/repos/petermatulis/docs/issues{/number}","pulls_url":"https://api.github.com/repos/petermatulis/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/petermatulis/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/petermatulis/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/petermatulis/docs/labels{/name}","releases_url":"https://api.github.com/repos/petermatulis/docs/releases{/id}","created_at":"2015-06-01T14:18:40Z","updated_at":"2015-06-01T14:18:40Z","pushed_at":"2015-06-15T23:36:31Z","git_url":"git://github.com/petermatulis/docs.git","ssh_url":"git@github.com:petermatulis/docs.git","clone_url":"https://github.com/petermatulis/docs.git","svn_url":"https://github.com/petermatulis/docs","homepage":"","size":11510,"stargazers_count":0,"watchers_count":0,"language":"Smarty","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":"juju:master","ref":"master","sha":"b89c2d26f2a456ec7dcde676607b6b708df4e272","user":{"login":"juju","id":4604548,"avatar_url":"https://avatars.githubusercontent.com/u/4604548?v=3","gravatar_id":"","url":"https://api.github.com/users/juju","html_url":"https://github.com/juju","followers_url":"https://api.github.com/users/juju/followers","following_url":"https://api.github.com/users/juju/following{/other_user}","gists_url":"https://api.github.com/users/juju/gists{/gist_id}","starred_url":"https://api.github.com/users/juju/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/juju/subscriptions","organizations_url":"https://api.github.com/users/juju/orgs","repos_url":"https://api.github.com/users/juju/repos","events_url":"https://api.github.com/users/juju/events{/privacy}","received_events_url":"https://api.github.com/users/juju/received_events","type":"Organization","site_admin":false},"repo":{"id":16817497,"name":"docs","full_name":"juju/docs","owner":{"login":"juju","id":4604548,"avatar_url":"https://avatars.githubusercontent.com/u/4604548?v=3","gravatar_id":"","url":"https://api.github.com/users/juju","html_url":"https://github.com/juju","followers_url":"https://api.github.com/users/juju/followers","following_url":"https://api.github.com/users/juju/following{/other_user}","gists_url":"https://api.github.com/users/juju/gists{/gist_id}","starred_url":"https://api.github.com/users/juju/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/juju/subscriptions","organizations_url":"https://api.github.com/users/juju/orgs","repos_url":"https://api.github.com/users/juju/repos","events_url":"https://api.github.com/users/juju/events{/privacy}","received_events_url":"https://api.github.com/users/juju/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/juju/docs","description":"Juju documentation, found online at https://jujucharms.com/docs","fork":false,"url":"https://api.github.com/repos/juju/docs","forks_url":"https://api.github.com/repos/juju/docs/forks","keys_url":"https://api.github.com/repos/juju/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/juju/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/juju/docs/teams","hooks_url":"https://api.github.com/repos/juju/docs/hooks","issue_events_url":"https://api.github.com/repos/juju/docs/issues/events{/number}","events_url":"https://api.github.com/repos/juju/docs/events","assignees_url":"https://api.github.com/repos/juju/docs/assignees{/user}","branches_url":"https://api.github.com/repos/juju/docs/branches{/branch}","tags_url":"https://api.github.com/repos/juju/docs/tags","blobs_url":"https://api.github.com/repos/juju/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/juju/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/juju/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/juju/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/juju/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/juju/docs/languages","stargazers_url":"https://api.github.com/repos/juju/docs/stargazers","contributors_url":"https://api.github.com/repos/juju/docs/contributors","subscribers_url":"https://api.github.com/repos/juju/docs/subscribers","subscription_url":"https://api.github.com/repos/juju/docs/subscription","commits_url":"https://api.github.com/repos/juju/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/juju/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/juju/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/juju/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/juju/docs/contents/{+path}","compare_url":"https://api.github.com/repos/juju/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/juju/docs/merges","archive_url":"https://api.github.com/repos/juju/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/juju/docs/downloads","issues_url":"https://api.github.com/repos/juju/docs/issues{/number}","pulls_url":"https://api.github.com/repos/juju/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/juju/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/juju/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/juju/docs/labels{/name}","releases_url":"https://api.github.com/repos/juju/docs/releases{/id}","created_at":"2014-02-13T21:16:13Z","updated_at":"2015-05-06T16:06:38Z","pushed_at":"2015-06-12T19:17:00Z","git_url":"git://github.com/juju/docs.git","ssh_url":"git@github.com:juju/docs.git","clone_url":"https://github.com/juju/docs.git","svn_url":"https://github.com/juju/docs","homepage":"","size":14278,"stargazers_count":9,"watchers_count":9,"language":"Smarty","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":56,"mirror_url":null,"open_issues_count":69,"forks":56,"open_issues":69,"watchers":9,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/juju/docs/pulls/476"},"html":{"href":"https://github.com/juju/docs/pull/476"},"issue":{"href":"https://api.github.com/repos/juju/docs/issues/476"},"comments":{"href":"https://api.github.com/repos/juju/docs/issues/476/comments"},"review_comments":{"href":"https://api.github.com/repos/juju/docs/pulls/476/comments"},"review_comment":{"href":"https://api.github.com/repos/juju/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/juju/docs/pulls/476/commits"},"statuses":{"href":"https://api.github.com/repos/juju/docs/statuses/54548fcb6fa7b88a4871dc71f9fa3716e4c83f90"}}}}