<div dir="ltr">So glad you're looking into this Solly!<br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Sep 18, 2013 at 2:52 PM, Solly Ross <span dir="ltr"><<a href="mailto:sross@redhat.com" target="_blank">sross@redhat.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">Does the Install Guide specifically avoid including documentation on Neutron setups, or is that just something that needs to be done?<br>
</blockquote><div><br></div><div>In the Grizzly release it did specifically avoid, because we had the Basic Guide covering Neutron. </div><div><br></div><div>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. <a href="https://etherpad.openstack.org/havanainstall">https://etherpad.openstack.org/havanainstall</a> has some notes. </div>
<div><br></div><div>Thanks,</div><div>Anne</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div class=""><div class="h5"><br>
----- Original Message -----<br>
From: "Andreas Jaeger" <<a href="mailto:aj@suse.com">aj@suse.com</a>><br>
To: "Solly Ross" <<a href="mailto:sross@redhat.com">sross@redhat.com</a>><br>
Cc: <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
Sent: Wednesday, September 18, 2013 3:37:15 PM<br>
Subject: Re: [Openstack-docs] Basic Install Guides<br>
<br>
On 09/18/2013 09:29 PM, Solly Ross wrote:<br>
> Hello All,<br>
> 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 (<a href="http://docs.openstack.org/trunk/basic-install/content/basic-install_intro.html" target="_blank">http://docs.openstack.org/trunk/basic-install/content/basic-install_intro.html</a>), 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.<br>
><br>
> 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.<br>
><br>
> 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?<br>
<br>
In general, update the version that is the git master. We had build all<br>
guides from the same sources.<br>
<br>
*BUT* with the current restructering of the documentation, the basic<br>
install guide is dead and will not be published for future releases.<br>
<br>
You should put your efforts in the Install Guide, it's in the git repo<br>
under "doc/install-guide" - and build in three different versions from<br>
the same sources.<br>
<br>
The current set of books that we plan to release for Havana are<br>
available via <a href="http://docs.openstack.org/trunk/" target="_blank">http://docs.openstack.org/trunk/</a><br>
<br>
Andreas<br>
--<br>
Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>