<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Apr 28, 2015 at 9:01 AM, Christian Berendt <span dir="ltr"><<a href="mailto:christian@berendt.io" target="_blank">christian@berendt.io</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"><span class="">On 04/28/2015 02:59 PM, Michael Klishin wrote:<br>
> I'm a RabbitMQ engineering team member and we'd like to help improve OpenStack docs<br>
> around it.<br>
<br>
</span>Welcome :)<br>
<span class=""><br>
> I've been reading the docs and making notes of what can be improved. We'd be happy<br>
> to contribute the changes. However, we're not very familiar with the OpenStack development<br>
> process and have a few questions before we start.<br>
<br>
</span>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>. We will discuss in<br>
Vancouver on the summit how to improve the experience for newcomers to<br>
the documentation.<br>
<span class=""><br>
> As far as I understand, OpenStack Kilo is about to ship. Does this mean we can only contribute<br>
> documentation improvements for the release after it? Are there maintenance releases that doc improvements<br>
> could go into? If so, how is this reflected in repository  branches?<br>
<br>
</span>In a few days there will be a stable/kilo branch. It is possible to<br>
backport changes from the current state of the repository to the stable<br>
branches. We do not have to wait for the regular maintaince release to<br>
publish changes there.<br></blockquote><div><br></div><div>All true, but specifically the ha-guide is in a separate repo and does not have any stable branches. It is continuously released, so you need to write in mind that operators could be approaching it from any of the three releases available to them. <a href="https://wiki.openstack.org/wiki/Releases">https://wiki.openstack.org/wiki/Releases</a></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">
<span class=""><br>
> Should the changes we propose be discussed on this list or in GitHub issues [1]?<br>
<br>
</span>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>
<span class=""><br>
> Finally, we are considering adding a doc guide dedicated to 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 that can go into more details.<br>
> Does this sound like a good idea to the OpenStack community? 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 we contribute? I don't think OpenStack Juno<br>
> docs have a lot of external links: is that by design?<br>
<br>
</span>I think it depends. It would be nice to have a working minimal guide for<br>
RabbitMQ inside the OpenStack documentation (as used at the moment in<br>
the installation guides).<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> ? I think<br>
such guides should be directly published on <a href="http://rabbitmq.com" target="_blank">rabbitmq.com</a>. I can assist<br>
while writing a guide for OpenStack.<br>
<span class=""><font color="#888888"><br></font></span></blockquote><div><br></div><div>I agree, we need to be extremely careful with what we can take on in the upstream docs, we are severely resource constrained. Can I use extreme and severe more? Probably, but want to emphasize we don't really take on more than we need to in upstream central docs team. We definitely want the write ups, but the judgement comes in where it's published. Lana's the PTL for Liberty so she can evaluate.</div><div><br></div><div>Anne</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"><span class=""><font color="#888888">
Christian.<br>
</font></span><span class="im"><br>
--<br>
Christian Berendt<br>
Cloud Computing Solution Architect<br>
Mail: <a href="mailto:berendt@b1-systems.de">berendt@b1-systems.de</a><br>
<br>
B1 Systems GmbH<br>
Osterfeldstraße 7 / 85088 Vohburg / <a href="http://www.b1-systems.de" target="_blank">http://www.b1-systems.de</a><br>
GF: Ralph Dehner / Unternehmenssitz: Vohburg / AG: Ingolstadt,HRB 3537<br>
<br>
</span><div class=""><div class="h5">_______________________________________________<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><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>