Open Stack

Hi Solly,

As Andreas and Anne mentioned, I'm working on restructuring things so we
don't have a separate "basic" install guide. The install guide will be
structured such that the first few chapters give a basic install, and
you can pick and choose the later chapters to add or change services.

I was planning on having the basic portion just use nova-network, based
on the feedback I've gotten from others. Although there's concern that
starting with a nova-network-based install and swapping in Neutron will
be too difficult.

I could use help with the Neutron chapter, or it probably won't end up
in the Havana release. I'm trying to get a patch in tonight. Then we can
talk about where to fit stuff in.

Thanks,
Shaun

On Wed, 2013-09-18 at 15:52 -0400, Solly Ross wrote:
> Does the Install Guide specifically avoid including documentation on
> Neutron setups, or is that just something that needs to be done?
> 
> ----- Original Message -----
> From: "Andreas Jaeger" <aj at suse.com>
> To: "Solly Ross" <sross at redhat.com>
> Cc: openstack-docs at lists.openstack.org
> Sent: Wednesday, September 18, 2013 3:37:15 PM
> Subject: Re: [Openstack-docs] Basic Install Guides
> 
> 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