Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-10-05 Thread Petr Kovar
On Wed, 4 Oct 2017 09:59:34 -0500 Jay S Bryant wrote: > > > On 9/29/2017 3:27 PM, Doug Hellmann wrote: > > Excerpts from Petr Kovar's message of 2017-09-29 21:09:02 +0200: > >> On Tue, 26 Sep 2017 18:53:04 -0500 > >> Jay S Bryant wrote: > >> > >>> >

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-10-04 Thread Jay S Bryant
On 9/29/2017 3:27 PM, Doug Hellmann wrote: Excerpts from Petr Kovar's message of 2017-09-29 21:09:02 +0200: On Tue, 26 Sep 2017 18:53:04 -0500 Jay S Bryant wrote: On 9/25/2017 3:47 AM, Alexandra Settle wrote: > I completely agree consistency is more

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-29 Thread Doug Hellmann
Excerpts from Petr Kovar's message of 2017-09-29 21:09:02 +0200: > On Tue, 26 Sep 2017 18:53:04 -0500 > Jay S Bryant wrote: > > > > > > > On 9/25/2017 3:47 AM, Alexandra Settle wrote: > > > > > > > I completely agree consistency is more important, than bike > > >

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-29 Thread Petr Kovar
On Tue, 26 Sep 2017 18:53:04 -0500 Jay S Bryant wrote: > > > On 9/25/2017 3:47 AM, Alexandra Settle wrote: > > > > > I completely agree consistency is more important, than bike shedding > > over the > > > name :) > > > To be honest, it would be easier

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-26 Thread Jay S Bryant
On 9/25/2017 3:47 AM, Alexandra Settle wrote: > I completely agree consistency is more important, than bike shedding over the > name :) > To be honest, it would be easier to change everything to ‘guide’ – seeing as > all our URLs are ‘install-guide’. > But that’s

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-25 Thread Alexandra Settle
> I completely agree consistency is more important, than bike shedding over the > name :) > To be honest, it would be easier to change everything to ‘guide’ – seeing as > all our URLs are ‘install-guide’. > But that’s the lazy in me speaking. > > Industry wise –

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-22 Thread Mike Perez
On 11:33 Sep 21, Alexandra Settle wrote: > > For me, a tutorial is something that teaches. So after I've gone through a > > tutorial I would expect to have learned how installs work and would > > just know > > these things (with an occasional need to reference a few points) going >

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-21 Thread Alexandra Settle
> For me, a tutorial is something that teaches. So after I've gone through a > tutorial I would expect to have learned how installs work and would just know > these things (with an occasional need to reference a few points) going forward. > > A guide to me is something that I

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-20 Thread Jay S Bryant
On 9/19/2017 4:57 PM, Sean McGinnis wrote: On 9/19/17, 2:43 PM, "Eric Fried" wrote: Alex- Regardless of what the dictionary might say, people associate the word "Tutorial" with a set of step-by-step instructions to do a thing. "Guide" would be

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-20 Thread Doug Hellmann
Excerpts from Sean McGinnis's message of 2017-09-19 16:57:40 -0500: > > > On 9/19/17, 2:43 PM, "Eric Fried" wrote: > > > > > > Alex- > > > > > > Regardless of what the dictionary might say, people associate the > > > word > > > "Tutorial" with a set of

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-19 Thread Sean McGinnis
> > On 9/19/17, 2:43 PM, "Eric Fried" wrote: > > > > Alex- > > > > Regardless of what the dictionary might say, people associate > > the word > > "Tutorial" with a set of step-by-step instructions to do a thing. > > "Guide" would be a more general

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-19 Thread Eric Fried
Alex-     The non-list reply was deliberate.  I honestly haven't looked at the docs in question, so really my answer was just me being pedantic about how I interpret those two words in general when I see them in technical literature.  Jay's concerns about consistency are probably more important.

Re: [openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-19 Thread Jay S Bryant
Alex, I have been working on getting updates to the Cinder Installation Tutorial ... Hadn't really even considered the word Tutorial in there to be honest as it just fit.  So, I think the important thing is that the pages be consistent in the terminology.  It looks like the common top level

[openstack-dev] [docs][ptls][install] Install guide vs. tutorial

2017-09-19 Thread Alexandra Settle
Hi everyone, I hope everyone had a safe trip home after the PTG! Since the doc-migration, quite a number or individuals have had questions regarding the usage of “Install Tutorial” vs. “Install Guide” in our documentation in the openstack-manuals repo and in the project-specific repos. We