[Openstack-docs] Basic Install Guides

Solly Ross sross at redhat.com
Wed Sep 18 19:29:45 UTC 2013


Hello All,
I wanted to inquire as to the state/future of the basic install guides.  Currently, as far a I can tell, there are three "basic install guides": the one at the root of the basic install docs (http://docs.openstack.org/trunk/basic-install/content/basic-install_intro.html), which seems to be the most robust although slightly out of date wrt the naming of neutron; the yum-specific guide; and the apt-specific guide (which is a bit of a misnomer, since the first guide is also written for apt).  While the latter two appear to be more up to date with naming, they are also much less detailed and seem to leave out important information.

I have followed the first of the listed basic install guides in an attempt to convert its more detailed information to Fedora/RHEL-compatible instructions.

My question is this: which basic install guides should get updated?  The tool-specific guides (the latter two) appear to target a slightly different setup than the first guide.  Should the first of the three guides be removed and its instructions merged into the APT-specific guide?  Should the APT-specific guide be scrapped (with an updated version of the first guide taking its place) and the yum-specific guide updated to match the setup of the first guide?

Best Regards,
Solly Ross



More information about the Openstack-docs mailing list