<div dir="ltr">So, what I'm picking up here...<div><br></div><div>1) Determine the projects that provide common configuration for most services (e.g., keystone-middleware, oslo.messaging, etc.) and work with them to develop and/or improve documentation that projects automatically consume to generate documentation and/or example configuration files. Gate jobs should also use the appropriate configuration for a particular release.</div><div><br></div><div>2) The installation guide (unintentionally) provides configuration not available in any other documentation. We should probably add and/or move such content to another guide more appropriate for existing operators. If this configuration particularly applies to upgrades, we should determine why our current documentation (mostly the configuration reference and release notes) fails to meet expectations.</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jul 11, 2016 at 9:33 AM, Edgar Magana <span dir="ltr"><<a href="mailto:edgar.magana@workday.com" target="_blank">edgar.magana@workday.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">







<div bgcolor="white" lang="EN-US" link="blue" vlink="purple">
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Inline.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><u></u> <u></u></span></p>
<div style="border:none;border-top:solid #b5c4df 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-family:Calibri;color:black">From: </span>
</b><span style="font-family:Calibri;color:black">Matt Kassawara <<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>><br>
<b>Date: </b>Monday, July 11, 2016 at 8:31 AM<span class=""><br>
<b>To: </b>Edgar Magana <<a href="mailto:edgar.magana@workday.com" target="_blank">edgar.magana@workday.com</a>><br>
<b>Cc: </b>Lana Brindley <<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>>, "<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>><br>
<b>Subject: </b>Re: [OpenStack-docs] Installation guides for Juno<u></u><u></u></span></span></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<div>
<div>
<p class="MsoNormal">The configuration reference should include the majority of changes between releases... plus release notes for recent releases. Of course, some projects *still* don't produce useful operator documentation, such as keystone-middleware which
 often requires some level of reverse engineering (often going against the example configuration and help strings) to configure the correct way. We could also work around the latter by adding some sort of content to the administrator guide that covers common
 configuration for each service.<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">I second the idea!  Thanks.<span class="HOEnZb"><font color="#888888"><u></u><u></u></font></span></p><span class="HOEnZb"><font color="#888888">
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">Edgar<u></u><u></u></p>
</font></span></div><div><div class="h5">
<div>
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<p class="MsoNormal">On Mon, Jul 11, 2016 at 9:26 AM, Edgar Magana <<a href="mailto:edgar.magana@workday.com" target="_blank">edgar.magana@workday.com</a>> wrote:<u></u><u></u></p>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">I do agree BUT sometimes we want to compare the old configuration with the new one in order to understand what will be required
 for new deployments versus previous staff. Then, we can adjust our configuration management tools.</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"> </span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Edgar</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"> </span><u></u><u></u></p>
<div style="border:none;border-top:solid #b5c4df 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-family:Calibri;color:black">From:
</span></b><span style="font-family:Calibri;color:black">Matt Kassawara <<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>><br>
<b>Date: </b>Monday, July 11, 2016 at 8:25 AM<br>
<b>To: </b>Edgar Magana <<a href="mailto:edgar.magana@workday.com" target="_blank">edgar.magana@workday.com</a>><br>
<b>Cc: </b>Lana Brindley <<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>>, "<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>></span><u></u><u></u></p>
<div>
<div>
<p class="MsoNormal"><br>
<b>Subject: </b>Re: [OpenStack-docs] Installation guides for Juno<u></u><u></u></p>
</div>
</div>
</div>
<div>
<div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<div>
<div>
<div>
<p class="MsoNormal">The primary audience of the installation guide involves potential new operators/users who should begin with the latest release, or at least a supported release. Existing operators
 with production deployments should probably avoid the installation guide because it only includes minimal configuration for each service.<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
<div>
<p class="MsoNormal">On Mon, Jul 11, 2016 at 9:16 AM, Edgar Magana <<a href="mailto:edgar.magana@workday.com" target="_blank">edgar.magana@workday.com</a>> wrote:<u></u><u></u></p>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<div>
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Our team still uses some of that documentation   :-(    (Seriously)</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"> </span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Edgar</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"> </span><u></u><u></u></p>
<div style="border:none;border-top:solid #b5c4df 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-family:Calibri;color:black">From:
</span></b><span style="font-family:Calibri;color:black">Matt Kassawara <<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>><br>
<b>Date: </b>Sunday, July 10, 2016 at 4:52 PM<br>
<b>To: </b>Lana Brindley <<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>><br>
<b>Cc: </b>"<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>><br>
<b>Subject: </b>Re: [OpenStack-docs] Installation guides for Juno</span><u></u><u></u></p>
</div>
<div>
<div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
<div>
<div>
<div>
<p class="MsoNormal">Looks like we need to do some deletions so Google can't find those pages.<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
<div>
<p class="MsoNormal">On Sun, Jul 10, 2016 at 5:05 PM, Lana Brindley <<a href="mailto:openstack@lanabrindley.com" target="_blank">openstack@lanabrindley.com</a>> wrote:<u></u><u></u></p>
<blockquote style="border:none;border-left:solid #cccccc 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<p class="MsoNormal" style="margin-bottom:12.0pt">Let's kill icehouse first. Stats:
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__i.imgur.com_I6n88pm.png&d=CwMFaQ&c=DS6PUFBBr_KiLo7Sjt3ljp5jaW5k2i9ijVXllEdOozc&r=G0XRJfDQsuBvqa_wpWyDAUlSpeMV4W1qfWqBfctlWwQ&m=AYMqHLqSJEg5ZysLVu67_txigkqua7PvFbbJjLJJx7M&s=FOyAAKq53m-AE_OkW07qA8e0OWhYxwCQ_0ifTiFFTAY&e=" target="_blank">
http://i.imgur.com/I6n88pm.png</a><br>
<br>
L<br>
<br>
On 09/07/16 00:46, Matt Kassawara wrote:<br>
> Can we get rid of the installation guides for Juno yet?<br>
><br>
><br>
> _______________________________________________<br>
> OpenStack-docs mailing list<br>
> <a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
> <a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__lists.openstack.org_cgi-2Dbin_mailman_listinfo_openstack-2Ddocs&d=CwMFaQ&c=DS6PUFBBr_KiLo7Sjt3ljp5jaW5k2i9ijVXllEdOozc&r=G0XRJfDQsuBvqa_wpWyDAUlSpeMV4W1qfWqBfctlWwQ&m=AYMqHLqSJEg5ZysLVu67_txigkqua7PvFbbJjLJJx7M&s=gb5z2lAao1oebvFZWXbnNuDTSUpYu1uL2kexNyfu3S8&e=" target="_blank">
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
><br>
<span style="color:#888888"><br>
--<br>
Lana Brindley<br>
Technical Writer<br>
Rackspace Cloud Builders Australia<br>
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__lanabrindley.com&d=CwMFaQ&c=DS6PUFBBr_KiLo7Sjt3ljp5jaW5k2i9ijVXllEdOozc&r=G0XRJfDQsuBvqa_wpWyDAUlSpeMV4W1qfWqBfctlWwQ&m=AYMqHLqSJEg5ZysLVu67_txigkqua7PvFbbJjLJJx7M&s=w68719XO3Gk4Pnv1ZCS_Ce_tQFdckqutf_gSBilTXDE&e=" target="_blank">http://lanabrindley.com</a><br>
<br>
</span><br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
<a href="https://urldefense.proofpoint.com/v2/url?u=http-3A__lists.openstack.org_cgi-2Dbin_mailman_listinfo_openstack-2Ddocs&d=CwMFaQ&c=DS6PUFBBr_KiLo7Sjt3ljp5jaW5k2i9ijVXllEdOozc&r=G0XRJfDQsuBvqa_wpWyDAUlSpeMV4W1qfWqBfctlWwQ&m=AYMqHLqSJEg5ZysLVu67_txigkqua7PvFbbJjLJJx7M&s=gb5z2lAao1oebvFZWXbnNuDTSUpYu1uL2kexNyfu3S8&e=" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><u></u><u></u></p>
</blockquote>
</div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"> <u></u><u></u></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
</div></div></div>
</div>
</div>
</div>

</blockquote></div><br></div>