Open Stack

On 09/18/2013 09:29 PM, Solly Ross wrote:
> 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?

In general, update the version that is the git master. We had build all
guides from the same sources.

*BUT* with the current restructering of the documentation, the basic
install guide is dead and will not be published for future releases.

You should put your efforts in the Install Guide, it's in the git repo
under "doc/install-guide" - and build in three different versions from
the same sources.

The current set of books that we plan to release for Havana are
available via http://docs.openstack.org/trunk/

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126