{"action":"created","comment":{"url":"https://api.github.com/repos/deis/workflow/pulls/comments/63556646","id":63556646,"diff_hunk":"@@ -1,13 +1,25 @@\n # Welcome to Deis Workflow\n \n-Deis (pronounced DAY-iss) Workflow is an open source Platform as a Service (PaaS) that adds a developer-friendly layer to any Kubernetes cluster, making it easy to deploy and manage applications on your own servers.\n+Deis (pronounced DAY-iss) Workflow is an open source Platform as a Service (PaaS) that adds a developer-friendly layer\n+to any Kubernetes cluster, making it easy to deploy and manage applications.\n \n-Workflow includes capabilities for building and deploying from source via `git push`, configuring your applications, creating and rolling back releases, managing application domain names and SSL certificates, providing edge routing, aggregating application logs, and controlling access to application resources.  All of this is exposed through a simple REST API and command line interface.\n+Deis Workflow includes capabilities for building and deploying from source via `git push`, configuring your applications,\n+creating and rolling back releases, managing application domain names and SSL certificates, providing edge routing,\n+aggregating application logs, and controlling access to application resources. All of this is exposed through a simple\n+REST API and command line interface.\n \n-For more detailed information about Workflow, view the [Concepts][concepts] and [Architecture][arch] sections.\n+## Getting Started\n+\n+Take a deep dive into Deis Workflow in our [Concepts][concepts], [Architecture][arch], and [Components][components]","path":"src/index.md","position":16,"original_position":16,"commit_id":"db143128042fc1d03d5e0d4df0a6263caf5d7fb9","original_commit_id":"db143128042fc1d03d5e0d4df0a6263caf5d7fb9","user":{"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},"body":"While it can sometimes feel more conversational or friendly, using first-person pronouns like \"we\" and \"our\" also creates a semantic distinction I don't think is appropriate for an open source project. I prefer:\r\n> Take a deep dive into Deis Workflow in **the** [Concepts][concepts], [Architecture][arch], ...\r\n\r\nIt's a finer point, however. And it may be pervasive. If others disagree feel free to ignore me.","created_at":"2016-05-17T16:31:06Z","updated_at":"2016-05-17T16:31:06Z","html_url":"https://github.com/deis/workflow/pull/225#discussion_r63556646","pull_request_url":"https://api.github.com/repos/deis/workflow/pulls/225","_links":{"self":{"href":"https://api.github.com/repos/deis/workflow/pulls/comments/63556646"},"html":{"href":"https://github.com/deis/workflow/pull/225#discussion_r63556646"},"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-17T16:31:06Z","closed_at":null,"merged_at":null,"merge_commit_sha":"bb74209fcc9830b1ba37b5274035a78db841cfb8","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":17,"state":"open","created_at":"2016-02-23T23:59:32Z","updated_at":"2016-05-17T16:19:42Z","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/db143128042fc1d03d5e0d4df0a6263caf5d7fb9","head":{"label":"slack:refactor-docs","ref":"refactor-docs","sha":"db143128042fc1d03d5e0d4df0a6263caf5d7fb9","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-17T01:08:39Z","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":16901,"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":"9c71b3aca2de31f61877943163db650fecf51e2e","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-17T09:06:09Z","pushed_at":"2016-05-17T16:19:43Z","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":17267,"stargazers_count":156,"watchers_count":156,"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":156,"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/db143128042fc1d03d5e0d4df0a6263caf5d7fb9"}}}}