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:
> >>
> >>>
>
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
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
> > >
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
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
> 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 –
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
>
> 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
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
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
> > 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
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.
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
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
14 matches
Mail list logo