Open Stack

I don't know what will get changed or created until the release, but
what I can find right now in terms of installation instructions is this:

https://docs.openstack.org/pike/install/

leading to the "OpenStack Installation Tutorial":

https://docs.openstack.org/install-guide/

plus many project-specific instructions:

https://docs.openstack.org/<project_name>/pike/install/

The OpenStack Installation Tuturial is labelled "Installation Guide
15.0", same as Ocata (Newton was 0.1). The URL is not versioned, even
though there will be changes between releases (the instructions for
enabling the OpenStack repository are updated every release, and there
are bound to be other differences). I wonder how that will be handled
in the future.

I have not read all of the new "OpenStack Installation Tutorial", but
looking at the table of contents, there seems to be a gap between
"Environment"->"Memcached" and "Launch an instance". Where do we tell the
readers which project-specific guides to follow, and in what order? Both
pieces of information are rather crucial for a successful installation.

I expect users will find confusing that clicking the "Next" arrow on a
distro-specific page (say, [1]) will often take them to the same page,
just for a different distro. In the keystone install-guide, clicking on
the Next arrow can result in skipped pages (depending on the distro,
e.g. [2]). I realize that distro-specific instructions are not easily
implemented with the new setup, but maybe the doc team could suggest
a way to handle distro-specific paths for all projects.

Roger

[1] https://docs.openstack.org/install-guide/environment-messaging-obs.html
[2] https://bugs.launchpad.net/keystone/+bug/1712335