Open Stack

So glad you're looking into this Solly!


On Wed, Sep 18, 2013 at 2:52 PM, Solly Ross <sross at redhat.com> wrote:

> Does the Install Guide specifically avoid including documentation on
> Neutron setups, or is that just something that needs to be done?
>

In the Grizzly release it did specifically avoid, because we had the Basic
Guide covering Neutron.

Shaun McCance is working on a "choose your own adventure" consolidation of
basic-install and install-guide -- that should cover about four or five
sample architectures. https://etherpad.openstack.org/havanainstall has some
notes.

Thanks,
Anne



>
> ----- 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
> --
>  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
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>



-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130918/028e3cbd/attachment.html>