{"action":"created","issue":{"url":"https://api.github.com/repos/openshift/openshift-docs/issues/658","labels_url":"https://api.github.com/repos/openshift/openshift-docs/issues/658/labels{/name}","comments_url":"https://api.github.com/repos/openshift/openshift-docs/issues/658/comments","events_url":"https://api.github.com/repos/openshift/openshift-docs/issues/658/events","html_url":"https://github.com/openshift/openshift-docs/issues/658","id":92215111,"number":658,"title":"Getting Start Guide is Too Spartan","user":{"login":"danjeffries1","id":13125640,"avatar_url":"https://avatars.githubusercontent.com/u/13125640?v=3","gravatar_id":"","url":"https://api.github.com/users/danjeffries1","html_url":"https://github.com/danjeffries1","followers_url":"https://api.github.com/users/danjeffries1/followers","following_url":"https://api.github.com/users/danjeffries1/following{/other_user}","gists_url":"https://api.github.com/users/danjeffries1/gists{/gist_id}","starred_url":"https://api.github.com/users/danjeffries1/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/danjeffries1/subscriptions","organizations_url":"https://api.github.com/users/danjeffries1/orgs","repos_url":"https://api.github.com/users/danjeffries1/repos","events_url":"https://api.github.com/users/danjeffries1/events{/privacy}","received_events_url":"https://api.github.com/users/danjeffries1/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-06-30T22:26:17Z","updated_at":"2015-07-06T11:32:42Z","closed_at":null,"body":"The Getting started guide is spartan.  The section for administrators is a single sentence:\r\n\r\nhttps://access.redhat.com/beta/documentation/en/openshift-enterprise-30-getting-started/chapter-3-getting-started-for-administrators\r\n\r\nIt links to a very short section that does not include much more information.  That document is here:  https://access.redhat.com/beta/documentation/en/openshift-enterprise-30-administrator-guide#quick-installation\r\n\r\nAt the very least the quick start guide should go through the various questions and choices available with the ose-installer script.  Instead it simply says that we should hit them and hope.\r\n\r\nAt the very least the getting started guide should link to the more comprehensive install documentation listed here:  https://access.redhat.com/beta/documentation/en/openshift-enterprise-30-administrator-guide/chapter-1-installation"},"comment":{"url":"https://api.github.com/repos/openshift/openshift-docs/issues/comments/118826350","html_url":"https://github.com/openshift/openshift-docs/issues/658#issuecomment-118826350","issue_url":"https://api.github.com/repos/openshift/openshift-docs/issues/658","id":118826350,"user":{"login":"danjeffries1","id":13125640,"avatar_url":"https://avatars.githubusercontent.com/u/13125640?v=3","gravatar_id":"","url":"https://api.github.com/users/danjeffries1","html_url":"https://github.com/danjeffries1","followers_url":"https://api.github.com/users/danjeffries1/followers","following_url":"https://api.github.com/users/danjeffries1/following{/other_user}","gists_url":"https://api.github.com/users/danjeffries1/gists{/gist_id}","starred_url":"https://api.github.com/users/danjeffries1/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/danjeffries1/subscriptions","organizations_url":"https://api.github.com/users/danjeffries1/orgs","repos_url":"https://api.github.com/users/danjeffries1/repos","events_url":"https://api.github.com/users/danjeffries1/events{/privacy}","received_events_url":"https://api.github.com/users/danjeffries1/received_events","type":"User","site_admin":false},"created_at":"2015-07-06T11:32:42Z","updated_at":"2015-07-06T11:32:42Z","body":"Thanks, Dan — mine was for internal consumption only as you know :). I can put on the PhD language, when needed, but I was trying to lighten the documentation mood. FWIW, as long as you can ensure that you have static IP, this works on any HV — I tried on Virtual Box as well, but I simply prefer VMware Fusion on the Mac — has a bit more pep. Had one SA say they could not install docker, and it was because they didn’t follow the instructions and disable all repos. I’ve done the install about 8 times with instructions at this point. It would be great to see the spirit of this guide used to fix 664.\n\nCheers,\nChris\n\n\n> On Jul 2, 2015, at 2:49 PM, Dan Jeffries <djeffrie@redhat.com> wrote:\n> \n> Check out Chris Morgan's workflow linked in issue 671:  https://github.com/openshift/openshift-docs/issues/671\n> \n> The screenshots would have to go/change as he is exposing his own employee key and his colloquial style would need to shift to boring business-ese but it has everything someone needs to get the environment setup.  They need some VMs, they need DNS and DHCP and they need to get the product installed.  As I see it any getting started guide is Exactly What It Says On The Tin:  http://tvtropes.org/pmwiki/pmwiki.php/Main/ExactlyWhatItSaysOnTheTin\n> \n> It needs to give people the essential information to get a complete environment up and running for testing and POC purposes.  \n> \n> All the best,\n> \n> Daniel Jeffries\n> Red Hat Senior Solutions Architect\n> RHCE - #805010231554810\n> San Diego, California\n> 619-955-7355  Office\n> 415-816-4497  Cell\n> \n> ----- Original Message -----\n> From: \"Bilhar Aulakh\" <notifications@github.com>\n> To: \"openshift/openshift-docs\" <openshift-docs@noreply.github.com>\n> Cc: \"danjeffries1\" <djeffries@redhat.com>\n> Sent: Wednesday, July 1, 2015 11:49:38 PM\n> Subject: Re: [openshift-docs] Getting Start Guide is Too Spartan (#658)\n> \n> @danjeffries1 Please see my comments in:  https://github.com/openshift/openshift-docs/issues/664\n> \n> I'm open to feedback/suggestions on what else to include in the Getting Started experience as per PR #664.\n> \n> ---\n> Reply to this email directly or view it on GitHub:\n> https://github.com/openshift/openshift-docs/issues/658#issuecomment-117933434\n\n"}}