<div dir="ltr">Good idea... I'll add it to the list of tasks in the primary bug.</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Mar 11, 2014 at 12:23 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">On 03/11/2014 06:00 PM, Matt Kassawara wrote:<br>
> As many of you already know, a group of us intend to update networking<br>
> portions of the installation guide for Icehouse. During analysis of the<br>
> project, we realized that the Neutron chapter would benefit from better<br>
> integration. For example, configuring Neutron requires a considerable<br>
> amount of jumping around the guide compared to legacy networking with<br>
> Nova. Many of these changes will affect other portions of the guide. For<br>
> example, the existing architectural and operating system configuration<br>
> examples don't thoroughly cover Neutron. Due to the extent of these<br>
> changes, the guide may periodically break for end-users attempting to<br>
> follow it. We created the following blueprint containing the proposed<br>
> layout:<br>
><br>
> <a href="https://blueprints.launchpad.net/openstack-manuals/+spec/networking-install-guide-improvements" target="_blank">https://blueprints.launchpad.net/openstack-manuals/+spec/networking-install-guide-improvements</a><br>

><br>
> Attempting to address these fairly significant changes with a single bug<br>
> report and massive patch would cause merge and review contention. On the<br>
> other hand, addressing each change with a separate bug report and<br>
> smaller patch would make tracking more difficult and inflate our total<br>
> bug count. We decided to meet in the middle by using a single bug report<br>
> referencing each change necessary to reach our goal and "partial-bug"<br>
> for patches addressing them.<br>
<br>
</div></div>Just one quick suggestion:<br>
<br>
I suggest that you add some big <warning>s at strategic places stating<br>
that the guide is currently updated for Icehouse and not fully updated.<br>
<span class="HOEnZb"><font color="#888888"><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>
</font></span></blockquote></div><br></div>