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 __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
