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

Mike Perez thingee at gmail.com
Fri Sep 22 22:26:54 UTC 2017


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
>     > forward.
>     >
>     > A guide to me is something that I know I will use whenever I need to do
>     > something. So for me, having an installation guide is what I would
>     > expect
>     > from this as every time I need to do a package based install, I am
>     > going to pull
>     > up the guide to go through it.
>     >
>    Interesting.
>     
>     So Sean has the opposite impression from Eric and I.  Yeah, that does 
>     make it seem like reaching a consensus will be difficult.
>     
>     At that point I think consistency becomes the most important thing.
>     
> 
> 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 – there does seem to be more of a trend towards ‘guide’ rather
> than ‘tutorial’. Although, that is at a cursory glance.
> 
> I am happy to investigate further, if this matter is of some contention to
> people?

This is the first time I'm hearing about "Install Tutorial". I'm also lazy, +1
with sticking to install guide.

-- 
Mike Perez
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20170922/3617fb2c/attachment.sig>


More information about the OpenStack-dev mailing list