{"action":"created","comment":{"url":"https://api.github.com/repos/deis/workflow/pulls/comments/63619655","id":63619655,"diff_hunk":"@@ -4,49 +4,63 @@\n #\n site_name: Deis Documentation\n pages:\n-  - Welcome: index.md\n-  - Quick Start: installing-workflow/quickstart.md\n+  - Home: index.md\n+  - Quick Start:\n+    - Overview: quickstart/index.md\n+    - Install CLI Tools: quickstart/install-cli-tools.md\n+    - AWS:\n+      - Boot: quickstart/provider/aws/boot.md\n+      - DNS: quickstart/provider/aws/dns.md\n+      - Install Workflow: quickstart/provider/aws/install-aws.md\n+    - GKE:\n+      - Boot: quickstart/provider/gke/boot.md\n+      - DNS: quickstart/provider/gke/dns.md\n+      - Install Workflow: quickstart/provider/gke/install-gke.md\n+    - Vagrant:\n+      - Boot: quickstart/provider/vagrant/boot.md\n+      - DNS: quickstart/provider/vagrant/dns.md\n+      - Install Workflow: quickstart/provider/vagrant/install-vagrant.md\n+    - Deploy Your First App: quickstart/deploy-an-app.md\n   - Understanding Workflow:\n     - Concepts: understanding-workflow/concepts.md\n     - Architecture: understanding-workflow/architecture.md\n     - Components: understanding-workflow/components.md\n   - Installing Workflow:\n-    - Quick Start: installing-workflow/quickstart.md\n+    - Installing Workflow: installing-workflow/index.md\n     - System Requirements: installing-workflow/system-requirements.md\n-    - Installing Workflow: installing-workflow/installing-deis-workflow.md\n     - Configuring Object Storage: installing-workflow/configuring-object-storage.md\n   - Using Workflow:\n-    - Installing the Client: using-workflow/installing-the-client.md\n-    - Registering a User: using-workflow/registering-a-user.md\n-    - Deploying an Application: using-workflow/deploying-an-application.md\n-    - Process Types and the Procfile: using-workflow/process-types-and-the-procfile.md\n-    - Using Buildpacks: using-workflow/using-buildpacks.md\n-    - Using Dockerfiles: using-workflow/using-dockerfiles.md\n-    - Using Docker Images: using-workflow/using-docker-images.md\n-    - Configuring an Application: using-workflow/configuring-an-application.md\n-    - Managing an Application: using-workflow/managing-an-application.md\n-    - Application SSL Certificates: using-workflow/application-ssl-certificates.md\n+    - Command Line Interface: using-workflow/cli.md\n+    - Users and Registration: using-workflow/users-and-registration.md\n+    - User SSH Keys: using-workflow/user-ssh-keys.md\n+  - Applications:","path":"mkdocs.yml","position":47,"original_position":47,"commit_id":"09809132cad82d0c0e64c89c276b1dd1f26608a3","original_commit_id":"23495aab7ce30739a8e8e46839b67be88d92b780","user":{"login":"slack","id":28873,"avatar_url":"https://avatars.githubusercontent.com/u/28873?v=3","gravatar_id":"","url":"https://api.github.com/users/slack","html_url":"https://github.com/slack","followers_url":"https://api.github.com/users/slack/followers","following_url":"https://api.github.com/users/slack/following{/other_user}","gists_url":"https://api.github.com/users/slack/gists{/gist_id}","starred_url":"https://api.github.com/users/slack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/slack/subscriptions","organizations_url":"https://api.github.com/users/slack/orgs","repos_url":"https://api.github.com/users/slack/repos","events_url":"https://api.github.com/users/slack/events{/privacy}","received_events_url":"https://api.github.com/users/slack/received_events","type":"User","site_admin":false},"body":"I ordered the stuff under the application section so that you could have a logical flow of detail...\r\n\r\nStart with deploy overview (which still needs work), then the build types, then process management, configuration, lifecycle (which I don't like and should be split out to scaling), etc...\r\n\r\n![2016-05-17 at 16 04](https://cloud.githubusercontent.com/assets/28873/15342320/3ff599c0-1c49-11e6-8384-9bc2fadc467e.png)\r\n\r\nDoes that track for you?","created_at":"2016-05-17T23:06:41Z","updated_at":"2016-05-17T23:06:41Z","html_url":"https://github.com/deis/workflow/pull/225#discussion_r63619655","pull_request_url":"https://api.github.com/repos/deis/workflow/pulls/225","_links":{"self":{"href":"https://api.github.com/repos/deis/workflow/pulls/comments/63619655"},"html":{"href":"https://github.com/deis/workflow/pull/225#discussion_r63619655"},"pull_request":{"href":"https://api.github.com/repos/deis/workflow/pulls/225"}}},"pull_request":{"url":"https://api.github.com/repos/deis/workflow/pulls/225","id":69571740,"html_url":"https://github.com/deis/workflow/pull/225","diff_url":"https://github.com/deis/workflow/pull/225.diff","patch_url":"https://github.com/deis/workflow/pull/225.patch","issue_url":"https://api.github.com/repos/deis/workflow/issues/225","number":225,"state":"open","locked":false,"title":"proposal: refactor quickstart and docs","user":{"login":"slack","id":28873,"avatar_url":"https://avatars.githubusercontent.com/u/28873?v=3","gravatar_id":"","url":"https://api.github.com/users/slack","html_url":"https://github.com/slack","followers_url":"https://api.github.com/users/slack/followers","following_url":"https://api.github.com/users/slack/following{/other_user}","gists_url":"https://api.github.com/users/slack/gists{/gist_id}","starred_url":"https://api.github.com/users/slack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/slack/subscriptions","organizations_url":"https://api.github.com/users/slack/orgs","repos_url":"https://api.github.com/users/slack/repos","events_url":"https://api.github.com/users/slack/events{/privacy}","received_events_url":"https://api.github.com/users/slack/received_events","type":"User","site_admin":false},"body":"Skeleton refactor to test new provider-specific flows.\n\nOne of the struggles I've had with the quickstart is that it has been\ncaught between among a task-oriented doc, platform reference and provider\nagnostic. The end-result is something that isn't compelling and ends up\nbeing particularly confusing for new visitors to the project.\n\nThis (now squashed) commit represents a deep refactor of the quickstart\ndocumentation.\n\nOrient the quickstart around a three step, goal-oriented process:\n\n1. Tools\n2. Infra + Workflow Install\n3. Deploy an example app\n\nThis also pulls in specific configurations of Kubernetes for evaluation and\ndev/test (kube-up.sh and GKE). We want tire-kickers to get a win and we\nneed to offer as much assistance through the process as possible.\n\nPre-install helm and deis CLIs up front.\n\nCouching the install in provider-specific workflows gives the documentation\nmuch needed context. For example, nuances about load balancer\nconfigurations (or lack there-of) can be dealt with in-context. This will\nsimplify the language as we can back away from routing folks to more\ndetailed explanations or landing a barrage of caveats.\n\nI also slimmed down the \"deploy your first app\" to the absolute basics.\nUsing the `deis/example-go` app lets folks get a win without having to deal\nwith cloning repos, etc. That stuff can go into reference documentation for\nthe three build types.\n\nClick through the GKE flow, that should be complete.\n\nThoughts would be great! Then we can do sections for Vagrant and AWS.","created_at":"2016-05-10T20:25:20Z","updated_at":"2016-05-17T23:06:41Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1d357bcf6796ead37b33d0a4811d22cd9bf4fd6b","assignee":{"login":"slack","id":28873,"avatar_url":"https://avatars.githubusercontent.com/u/28873?v=3","gravatar_id":"","url":"https://api.github.com/users/slack","html_url":"https://github.com/slack","followers_url":"https://api.github.com/users/slack/followers","following_url":"https://api.github.com/users/slack/following{/other_user}","gists_url":"https://api.github.com/users/slack/gists{/gist_id}","starred_url":"https://api.github.com/users/slack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/slack/subscriptions","organizations_url":"https://api.github.com/users/slack/orgs","repos_url":"https://api.github.com/users/slack/repos","events_url":"https://api.github.com/users/slack/events{/privacy}","received_events_url":"https://api.github.com/users/slack/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/deis/workflow/milestones/2","html_url":"https://github.com/deis/workflow/milestones/v2.0-rc1","labels_url":"https://api.github.com/repos/deis/workflow/milestones/2/labels","id":1601373,"number":2,"title":"v2.0-rc1","description":"","creator":{"login":"mboersma","id":73019,"avatar_url":"https://avatars.githubusercontent.com/u/73019?v=3","gravatar_id":"","url":"https://api.github.com/users/mboersma","html_url":"https://github.com/mboersma","followers_url":"https://api.github.com/users/mboersma/followers","following_url":"https://api.github.com/users/mboersma/following{/other_user}","gists_url":"https://api.github.com/users/mboersma/gists{/gist_id}","starred_url":"https://api.github.com/users/mboersma/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mboersma/subscriptions","organizations_url":"https://api.github.com/users/mboersma/orgs","repos_url":"https://api.github.com/users/mboersma/repos","events_url":"https://api.github.com/users/mboersma/events{/privacy}","received_events_url":"https://api.github.com/users/mboersma/received_events","type":"User","site_admin":false},"open_issues":12,"closed_issues":18,"state":"open","created_at":"2016-02-23T23:59:32Z","updated_at":"2016-05-17T21:27:59Z","due_on":"2016-05-25T06:00:00Z","closed_at":null},"commits_url":"https://api.github.com/repos/deis/workflow/pulls/225/commits","review_comments_url":"https://api.github.com/repos/deis/workflow/pulls/225/comments","review_comment_url":"https://api.github.com/repos/deis/workflow/pulls/comments{/number}","comments_url":"https://api.github.com/repos/deis/workflow/issues/225/comments","statuses_url":"https://api.github.com/repos/deis/workflow/statuses/09809132cad82d0c0e64c89c276b1dd1f26608a3","head":{"label":"slack:refactor-docs","ref":"refactor-docs","sha":"09809132cad82d0c0e64c89c276b1dd1f26608a3","user":{"login":"slack","id":28873,"avatar_url":"https://avatars.githubusercontent.com/u/28873?v=3","gravatar_id":"","url":"https://api.github.com/users/slack","html_url":"https://github.com/slack","followers_url":"https://api.github.com/users/slack/followers","following_url":"https://api.github.com/users/slack/following{/other_user}","gists_url":"https://api.github.com/users/slack/gists{/gist_id}","starred_url":"https://api.github.com/users/slack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/slack/subscriptions","organizations_url":"https://api.github.com/users/slack/orgs","repos_url":"https://api.github.com/users/slack/repos","events_url":"https://api.github.com/users/slack/events{/privacy}","received_events_url":"https://api.github.com/users/slack/received_events","type":"User","site_admin":false},"repo":{"id":52543368,"name":"workflow","full_name":"slack/workflow","owner":{"login":"slack","id":28873,"avatar_url":"https://avatars.githubusercontent.com/u/28873?v=3","gravatar_id":"","url":"https://api.github.com/users/slack","html_url":"https://github.com/slack","followers_url":"https://api.github.com/users/slack/followers","following_url":"https://api.github.com/users/slack/following{/other_user}","gists_url":"https://api.github.com/users/slack/gists{/gist_id}","starred_url":"https://api.github.com/users/slack/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/slack/subscriptions","organizations_url":"https://api.github.com/users/slack/orgs","repos_url":"https://api.github.com/users/slack/repos","events_url":"https://api.github.com/users/slack/events{/privacy}","received_events_url":"https://api.github.com/users/slack/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/slack/workflow","description":"Deis v2 beta documentation","fork":true,"url":"https://api.github.com/repos/slack/workflow","forks_url":"https://api.github.com/repos/slack/workflow/forks","keys_url":"https://api.github.com/repos/slack/workflow/keys{/key_id}","collaborators_url":"https://api.github.com/repos/slack/workflow/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/slack/workflow/teams","hooks_url":"https://api.github.com/repos/slack/workflow/hooks","issue_events_url":"https://api.github.com/repos/slack/workflow/issues/events{/number}","events_url":"https://api.github.com/repos/slack/workflow/events","assignees_url":"https://api.github.com/repos/slack/workflow/assignees{/user}","branches_url":"https://api.github.com/repos/slack/workflow/branches{/branch}","tags_url":"https://api.github.com/repos/slack/workflow/tags","blobs_url":"https://api.github.com/repos/slack/workflow/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/slack/workflow/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/slack/workflow/git/refs{/sha}","trees_url":"https://api.github.com/repos/slack/workflow/git/trees{/sha}","statuses_url":"https://api.github.com/repos/slack/workflow/statuses/{sha}","languages_url":"https://api.github.com/repos/slack/workflow/languages","stargazers_url":"https://api.github.com/repos/slack/workflow/stargazers","contributors_url":"https://api.github.com/repos/slack/workflow/contributors","subscribers_url":"https://api.github.com/repos/slack/workflow/subscribers","subscription_url":"https://api.github.com/repos/slack/workflow/subscription","commits_url":"https://api.github.com/repos/slack/workflow/commits{/sha}","git_commits_url":"https://api.github.com/repos/slack/workflow/git/commits{/sha}","comments_url":"https://api.github.com/repos/slack/workflow/comments{/number}","issue_comment_url":"https://api.github.com/repos/slack/workflow/issues/comments{/number}","contents_url":"https://api.github.com/repos/slack/workflow/contents/{+path}","compare_url":"https://api.github.com/repos/slack/workflow/compare/{base}...{head}","merges_url":"https://api.github.com/repos/slack/workflow/merges","archive_url":"https://api.github.com/repos/slack/workflow/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/slack/workflow/downloads","issues_url":"https://api.github.com/repos/slack/workflow/issues{/number}","pulls_url":"https://api.github.com/repos/slack/workflow/pulls{/number}","milestones_url":"https://api.github.com/repos/slack/workflow/milestones{/number}","notifications_url":"https://api.github.com/repos/slack/workflow/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/slack/workflow/labels{/name}","releases_url":"https://api.github.com/repos/slack/workflow/releases{/id}","deployments_url":"https://api.github.com/repos/slack/workflow/deployments","created_at":"2016-02-25T17:27:01Z","updated_at":"2016-03-16T18:46:00Z","pushed_at":"2016-05-17T22:49:42Z","git_url":"git://github.com/slack/workflow.git","ssh_url":"git@github.com:slack/workflow.git","clone_url":"https://github.com/slack/workflow.git","svn_url":"https://github.com/slack/workflow","homepage":null,"size":16892,"stargazers_count":0,"watchers_count":0,"language":"CSS","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":"deis:master","ref":"master","sha":"2d2b937a0f2833044a7830292a733b1e2d66fac4","user":{"login":"deis","id":6117407,"avatar_url":"https://avatars.githubusercontent.com/u/6117407?v=3","gravatar_id":"","url":"https://api.github.com/users/deis","html_url":"https://github.com/deis","followers_url":"https://api.github.com/users/deis/followers","following_url":"https://api.github.com/users/deis/following{/other_user}","gists_url":"https://api.github.com/users/deis/gists{/gist_id}","starred_url":"https://api.github.com/users/deis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/deis/subscriptions","organizations_url":"https://api.github.com/users/deis/orgs","repos_url":"https://api.github.com/users/deis/repos","events_url":"https://api.github.com/users/deis/events{/privacy}","received_events_url":"https://api.github.com/users/deis/received_events","type":"Organization","site_admin":false},"repo":{"id":52381034,"name":"workflow","full_name":"deis/workflow","owner":{"login":"deis","id":6117407,"avatar_url":"https://avatars.githubusercontent.com/u/6117407?v=3","gravatar_id":"","url":"https://api.github.com/users/deis","html_url":"https://github.com/deis","followers_url":"https://api.github.com/users/deis/followers","following_url":"https://api.github.com/users/deis/following{/other_user}","gists_url":"https://api.github.com/users/deis/gists{/gist_id}","starred_url":"https://api.github.com/users/deis/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/deis/subscriptions","organizations_url":"https://api.github.com/users/deis/orgs","repos_url":"https://api.github.com/users/deis/repos","events_url":"https://api.github.com/users/deis/events{/privacy}","received_events_url":"https://api.github.com/users/deis/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/deis/workflow","description":"Deis Workflow, an open source Kubernetes PaaS.","fork":false,"url":"https://api.github.com/repos/deis/workflow","forks_url":"https://api.github.com/repos/deis/workflow/forks","keys_url":"https://api.github.com/repos/deis/workflow/keys{/key_id}","collaborators_url":"https://api.github.com/repos/deis/workflow/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/deis/workflow/teams","hooks_url":"https://api.github.com/repos/deis/workflow/hooks","issue_events_url":"https://api.github.com/repos/deis/workflow/issues/events{/number}","events_url":"https://api.github.com/repos/deis/workflow/events","assignees_url":"https://api.github.com/repos/deis/workflow/assignees{/user}","branches_url":"https://api.github.com/repos/deis/workflow/branches{/branch}","tags_url":"https://api.github.com/repos/deis/workflow/tags","blobs_url":"https://api.github.com/repos/deis/workflow/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/deis/workflow/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/deis/workflow/git/refs{/sha}","trees_url":"https://api.github.com/repos/deis/workflow/git/trees{/sha}","statuses_url":"https://api.github.com/repos/deis/workflow/statuses/{sha}","languages_url":"https://api.github.com/repos/deis/workflow/languages","stargazers_url":"https://api.github.com/repos/deis/workflow/stargazers","contributors_url":"https://api.github.com/repos/deis/workflow/contributors","subscribers_url":"https://api.github.com/repos/deis/workflow/subscribers","subscription_url":"https://api.github.com/repos/deis/workflow/subscription","commits_url":"https://api.github.com/repos/deis/workflow/commits{/sha}","git_commits_url":"https://api.github.com/repos/deis/workflow/git/commits{/sha}","comments_url":"https://api.github.com/repos/deis/workflow/comments{/number}","issue_comment_url":"https://api.github.com/repos/deis/workflow/issues/comments{/number}","contents_url":"https://api.github.com/repos/deis/workflow/contents/{+path}","compare_url":"https://api.github.com/repos/deis/workflow/compare/{base}...{head}","merges_url":"https://api.github.com/repos/deis/workflow/merges","archive_url":"https://api.github.com/repos/deis/workflow/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/deis/workflow/downloads","issues_url":"https://api.github.com/repos/deis/workflow/issues{/number}","pulls_url":"https://api.github.com/repos/deis/workflow/pulls{/number}","milestones_url":"https://api.github.com/repos/deis/workflow/milestones{/number}","notifications_url":"https://api.github.com/repos/deis/workflow/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/deis/workflow/labels{/name}","releases_url":"https://api.github.com/repos/deis/workflow/releases{/id}","deployments_url":"https://api.github.com/repos/deis/workflow/deployments","created_at":"2016-02-23T18:14:58Z","updated_at":"2016-05-17T17:28:06Z","pushed_at":"2016-05-17T22:49:42Z","git_url":"git://github.com/deis/workflow.git","ssh_url":"git@github.com:deis/workflow.git","clone_url":"https://github.com/deis/workflow.git","svn_url":"https://github.com/deis/workflow","homepage":"https://deis.com","size":17256,"stargazers_count":157,"watchers_count":157,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":30,"mirror_url":null,"open_issues_count":25,"forks":30,"open_issues":25,"watchers":157,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/deis/workflow/pulls/225"},"html":{"href":"https://github.com/deis/workflow/pull/225"},"issue":{"href":"https://api.github.com/repos/deis/workflow/issues/225"},"comments":{"href":"https://api.github.com/repos/deis/workflow/issues/225/comments"},"review_comments":{"href":"https://api.github.com/repos/deis/workflow/pulls/225/comments"},"review_comment":{"href":"https://api.github.com/repos/deis/workflow/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/deis/workflow/pulls/225/commits"},"statuses":{"href":"https://api.github.com/repos/deis/workflow/statuses/09809132cad82d0c0e64c89c276b1dd1f26608a3"}}}}