<div dir="ltr"><div>Michael,</div><div><br></div>Although the installation guide only covers a simple environment that doesn't stress resources such as RabbitMQ, I think it would benefit from configuration recommendations or tweaks that ease growth toward production environments. This includes OpenStack service configuration options that control communication with RabbitMQ.<div><br></div><div>Besides covering RabbitMQ in the HA guide, I think we're tossing around the idea of asking some operators to contribute practical/scalable deployment methods and configurations, most of which probably include RabbitMQ.</div><div><br></div><div>Matt</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Apr 28, 2015 at 6:01 PM, Tom Fifield <span dir="ltr"><<a href="mailto:tom@openstack.org" target="_blank">tom@openstack.org</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 28/04/15 23:47, Michael Klishin wrote:<br>
> On 28 April 2015 at 17:24:56, Anne Gentle (<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>) wrote:<br>
>> The entry point for documentation is<br>
>> <a href="https://wiki.openstack.org/wiki/Documentation/HowTo" target="_blank">https://wiki.openstack.org/wiki/Documentation/HowTo</a>.<br>
><br>
> Thank you.<br>
><br>
>> We will discuss in<br>
>> Vancouver on the summit how to improve the experience for newcomers<br>
>> to<br>
>> the documentation.<br>
><br>
> By the way, I attend it, including the design summit. Do I need to RSVP somewhere to join that session? :)<br>
><br>
>>> As far as I understand, OpenStack Kilo is about to ship. Does<br>
>> this mean we can only contribute<br>
>>> documentation improvements for the release after it? Are there<br>
>> maintenance releases that doc improvements<br>
>>> could go into? If so, how is this reflected in repository branches?<br>
>><br>
>> In a few days there will be a stable/kilo branch. It is possible<br>
>> to<br>
>> backport changes from the current state of the repository to<br>
>> the stable<br>
>> branches. We do not have to wait for the regular maintaince release<br>
>> to<br>
>> publish changes there.<br>
><br>
> Perfect.<br>
><br>
>>> Should the changes we propose be discussed on this list or in<br>
>> GitHub issues [1]?<br>
>><br>
>> On this list or on launchpad. We do not use the Github issues.<br>
>><br>
>> <a href="https://launchpad.net/openstack-manuals" target="_blank">https://launchpad.net/openstack-manuals</a><br>
><br>
> Got it. I suspect developer docs cover how patches are submitted.<br>
><br>
>>> Finally, we are considering adding a doc guide dedicated to<br>
>> OpenStack on <a href="http://rabbitmq.com" target="_blank">rabbitmq.com</a> (we have one for EC2,<br>
>>> for instance). Note that we are not looking<br>
>>> to replace what's on <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a>, only provide a guide<br>
>> that can go into more details.<br>
>>> Does this sound like a good idea to the OpenStack community?<br>
>> Should we keep everything on <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a>?<br>
>>> Would it be OK if we link to <a href="http://rabbitmq.com" target="_blank">rabbitmq.com</a> guides in any changes<br>
>> we contribute? I don't think OpenStack Juno<br>
>>> docs have a lot of external links: is that by design?<br>
>><br>
>> I think it depends. It would be nice to have a working minimal guide<br>
>> for<br>
>> RabbitMQ inside the OpenStack documentation (as used at the<br>
>> moment in<br>
>> the installation guides).<br>
><br>
> I agree.<br>
><br>
>> Do you mean this EC2 guide: <a href="http://www.rabbitmq.com/ec2.html" target="_blank">http://www.rabbitmq.com/ec2.html</a><br>
>> ?<br>
><br>
> That's the one, yes.<br>
><br>
>> I think<br>
>> such guides should be directly published on <a href="http://rabbitmq.com" target="_blank">rabbitmq.com</a>. I<br>
>> can assist<br>
>> while writing a guide for OpenStack.<br>
><br>
> We are leaning towards this, too: have a minimalistic guide on <a href="http://openstack.org" target="_blank">openstack.org</a><br>
> and link to relevant parts on <a href="http://rabbitmq.com" target="_blank">rabbitmq.com</a>, then introduce a separate guide for OpenStack<br>
> users that we'll maintain.<br>
><br>
> Thank you, folks. This has been very helpful. We'll get to work on the patches :)<br>
<br>
</div></div>Thank _you_ Michael. One more handy link:<br>
<br>
<a href="http://docs.openstack.org/draft/draft-index.html" target="_blank">http://docs.openstack.org/draft/draft-index.html</a><br>
<br>
That's where you'll find the current docs being worked on that are not<br>
yet published. It's particularly useful for looking at kilo install guides.<br>
<div class="HOEnZb"><div class="h5"><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></div>