<html><body><div style="color:#000; background-color:#fff; font-family:HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:12px"><div id="yui_3_16_0_1_1430227872797_442640">Michael, the HA Guide team meets on Thursday and we would love to discuss your plans.</div><div dir="ltr" id="yui_3_16_0_1_1430227872797_442642">This document has details -- I expect that this week's agenda will be added before Thursday:<br></div><div id="yui_3_16_0_1_1430227872797_442474"><br></div><div dir="ltr" id="yui_3_16_0_1_1430227872797_442475"><a id="yui_3_16_0_1_1430227872797_442478" href="https://wiki.openstack.org/wiki/Documentation/HA_Guide_Update#Next_Meeting">Documentation/HA Guide Update - OpenStack</a></div><div id="yui_3_16_0_1_1430227872797_442937" dir="ltr"><br></div><div style="width:450px; font-family: 'Georgia', 'Times', 'Times New Roman', 'serif';margin-top:5px; margin-bottom: 5px; background-color: #ffffff;" id="enhancrCard_1" class="link-enhancr-attachment link-enhancr-element" contenteditable="false"><table id="yui_3_16_0_1_1430227872797_443232" class="link-enhancr-element" style="width:450px; height:auto; position: relative; display: block;" border="0" cellpadding="0" cellspacing="0"><tbody id="yui_3_16_0_1_1430227872797_443231"><tr id="yui_3_16_0_1_1430227872797_443230" class="link-enhancr-element"><td id="yui_3_16_0_1_1430227872797_443229" class="link-enhancr-element" colspan="7" style="height: 1px; background-color: #e5e5e5; font-size: 1px; border-collapse: collapse;"><div id="yui_3_16_0_1_1430227872797_443228" class="link-enhancr-element" style="height: 1px; background-color: #e5e5e5; font-size: 1px; line-height:0px;"> </div></td></tr><tr class="link-enhancr-element"><td rowspan="5" class="link-enhancr-element" style="width: 1px; background-color: #e5e5e5; font-size: 1pt; border-collapse: collapse;"><div class="link-enhancr-element" style="width: 1px; background-color: #e5e5e5; font-size: 1pt;"> </div></td><td rowspan="5" class="link-enhancr-element" style="width: 14px; background-color: #ffffff; font-size: 0pt; border-collapse: collapse;"><div class="link-enhancr-element" style="width: 14px; background-color: #ffffff; font-size: 14pt;"> </div></td><td colspan="2" class="link-enhancr-element" style="height: 6px; background-color: #ffffff; font-size: 0pt; border-collapse: collapse;"><div class="link-enhancr-element" style="height: 6px; background-color: #ffffff; font-size: 6pt;"> </div></td><td rowspan="5" class="link-enhancr-element" style="width: 20px; background-color: #ffffff; font-size: 0pt; border-collapse: collapse;"><div class="link-enhancr-element" style="width: 20px; background-color: #ffffff; font-size: 20pt;"> </div></td><td class="link-enhancr-element" rowspan="5" style="width: 1px; background-color: #e5e5e5; font-size: 1pt; border-collapse: collapse;" width="1"><div class="link-enhancr-element" style="width: 1px; background-color: #e5e5e5; font-size: 1pt;"> </div></td></tr><tr id="yui_3_16_0_1_1430227872797_443238"><td id="yui_3_16_0_1_1430227872797_443237" class="link-enhancr-element" colspan="2" style="width: 100%; vertical-align: middle; font-family: 'Georgia', 'Times', 'Times New Roman', 'serif';"><div id="yui_3_16_0_1_1430227872797_443236" class="link-enhancr-text-part link-enhancr-element" style="line-height:16.5px; background-color: #ffffff; width: 414px;"><div id="yui_3_16_0_1_1430227872797_443235" class="link-enhancr-element" style="word-wrap: break-word; word-break: break-all;"><span class="link-enhancr-element icon icon-shrink link-enhancr-toggle"></span><span class="link-enhancr-element icon icon-close link-enhancr-delete"></span><a id="yui_3_16_0_1_1430227872797_443234" href="https://wiki.openstack.org/wiki/Documentation/HA_Guide_Update#Next_Meeting" class="link-enhancr-card-urlWrapper link-enhancr-element" style="text-decoration: none !important; color: #000000 !important; line-height: 100%; font-size: 18px; display: block;"><span class="link-enhancr-element link-enhancr-card-title" style="margin: 0; font-weight: normal;margin-bottom: 3px; font-size: 18px; line-height: 21px; max-height: 43px; color: #000000; overflow: hidden !important; display: inline-block;">Documentation/HA Guide Update - OpenStack</span></a><div style="font-size: 13px; line-height: 20px; color: #999999; max-height: 81px; font-family: 'Georgia', 'Times', 'Times New Roman', 'serif';overflow: hidden;" class="link-enhancr-card-description link-enhancr-element">Contents 1 HA Guide Update 1.1 What 1.2 Next Meeting 1.3 Past Meetings 1.4 Where 1.5 Project HA Status Tracker 1.6 Bug Bash 1.6.1 Logistics 1.6.2 Suggested Priority 1.6.3 Things to Note </div></div></div></td></tr><tr><td colspan="2" class="link-enhancr-element" style="height: 6px; background-color: #ffffff; font-size: 0pt; border-collapse: collapse;"><div class="link-enhancr-element" style="height: 6px; background-color: #ffffff; font-size: 6pt;"></div></td></tr><tr id="yui_3_16_0_1_1430227872797_443245"><td id="yui_3_16_0_1_1430227872797_443244" class="link-enhancr-element" style="vertical-align: middle; font-family: 'Arial', 'Helvetica Neue', 'Helvetica', 'sans-serif';"><div id="yui_3_16_0_1_1430227872797_443243" class="link-enhancr-element" style="font-size: 0pt;"><a id="yui_3_16_0_1_1430227872797_443242" href="https://wiki.openstack.org/wiki/Documentation/HA_Guide_Update#Next_Meeting" class="link-enhancr-card-url link-enhancr-element" style="color: black; text-decoration: none !important;cursor:pointer !important;" target="_blank"><span id="yui_3_16_0_1_1430227872797_442636" class="link-enhancr-element link-enhancr-view-on" style="display: inline-block; line-height: 11px; max-width: 314px; min-width: 254px; overflow: hidden; max-height: 13px; word-break: break-all;"><span id="yui_3_16_0_1_1430227872797_443241" class="link-enhancr-element link-enhancr-mobile-no-resize" style="vertical-align:middle; font-size: 9px; line-height: 11px; color: #999999; -moz-text-size-adjust: none; -ms-text-size-adjust: none; -webkit-text-size-adjust:none; text-size-adjust:none;">View on <span id="yui_3_16_0_1_1430227872797_443240" style="font-weight: bold" class="link-enhancr-view-on-domain">wiki.openstack.org</span></span></span></a></div></td><td class="link-enhancr-element" style="vertical-align: middle; width: 100px; font-family: 'Arial', 'Helvetica Neue', 'Helvetica', 'sans-serif';"><div class="link-enhancr-element link-enhancr-preview-wrapper" style="max-width: 100px; min-width: 80px; overflow: hidden; text-align: right; line-height: 11px; max-height: 13px; font-size: 0pt;"><span class="link-enhancr-element link-enhancr-preview-by link-enhancr-mobile-no-resize" style="vertical-align:middle; font-size: 9px; line-height: 11px; color: #999999; -moz-text-size-adjust: none; -ms-text-size-adjust: none; -webkit-text-size-adjust:none; text-size-adjust:none;">Preview by Yahoo</span></div></td></tr><tr><td colspan="2" class="link-enhancr-element" style="height: 9px; background-color: #ffffff; font-size: 0pt; border-collapse: collapse;"><div class="link-enhancr-element" style="height: 9px; background-color: #ffffff; font-size: 9pt;"></div></td></tr><tr class="link-enhancr-element"><td class="link-enhancr-element" colspan="7" style="height: 1px; background-color: #e5e5e5; font-size: 1px; border-collapse: collapse;"><div class="link-enhancr-element" style="height: 1px; background-color: #e5e5e5; font-size: 1px; line-height:0px"> </div></td></tr></tbody></table></div><div id="yui_3_16_0_1_1430227872797_442473"><span></span></div><br> <blockquote id="yui_3_16_0_1_1430227872797_442469" style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"> <div id="yui_3_16_0_1_1430227872797_442468" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 12px;"> <div id="yui_3_16_0_1_1430227872797_442467" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1430227872797_442466" dir="ltr"> <hr id="yui_3_16_0_1_1430227872797_442471" size="1"> <font id="yui_3_16_0_1_1430227872797_443246" face="Arial" size="2"> <b><span style="font-weight:bold;">From:</span></b> Lana Brindley <openstack@lanabrindley.com><br> <b><span style="font-weight: bold;">To:</span></b> openstack-docs@lists.openstack.org <br> <b><span style="font-weight: bold;">Sent:</span></b> Tuesday, April 28, 2015 4:23 PM<br> <b><span style="font-weight: bold;">Subject:</span></b> Re: [OpenStack-docs] Improving OpenStack documentation around RabbitMQ<br> </font> </div> <div id="yui_3_16_0_1_1430227872797_443248" class="y_msg_container"><br>-----BEGIN PGP SIGNED MESSAGE-----<br clear="none">Hash: SHA1<br clear="none"><br clear="none">On 29/04/15 01:47, Michael Klishin wrote:<br clear="none">> On 28 April 2015 at 17:24:56, Anne Gentle (<a shape="rect" ymailto="mailto:annegentle@justwriteclick.com" href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>) wrote:<br clear="none">>> The entry point for documentation is<br clear="none">>> https://wiki.openstack.org/wiki/Documentation/HowTo.<br clear="none">> <br clear="none">> Thank you.<br clear="none">><br clear="none"><br clear="none">Hi Michael, and welcome :)<br clear="none"><br clear="none"><br clear="none">>> We will discuss in<br clear="none">>> Vancouver on the summit how to improve the experience for newcomers <br clear="none">>> to<br clear="none">>> the documentation.<br clear="none">> <br clear="none">> By the way, I attend it, including the design summit. Do I need to RSVP somewhere to join that session? :)<br clear="none"><br clear="none">You don't need to specifically RSVP, just turn up to the session. I'm<br clear="none">still finalising the schedule, but should have something up by the end<br clear="none">of this week. Keep an eye on this mailing list for more info soon.<br clear="none"><br clear="none">> <br clear="none">>>> As far as I understand, OpenStack Kilo is about to ship. Does <br clear="none">>> this mean we can only contribute<br clear="none">>>> documentation improvements for the release after it? Are there <br clear="none">>> maintenance releases that doc improvements<br clear="none">>>> could go into? If so, how is this reflected in repository branches? <br clear="none">>> <br clear="none">>> In a few days there will be a stable/kilo branch. It is possible <br clear="none">>> to<br clear="none">>> backport changes from the current state of the repository to <br clear="none">>> the stable<br clear="none">>> branches. We do not have to wait for the regular maintaince release <br clear="none">>> to<br clear="none">>> publish changes there.<br clear="none">> <br clear="none">> Perfect.<br clear="none">> <br clear="none">>>> Should the changes we propose be discussed on this list or in <br clear="none">>> GitHub issues [1]?<br clear="none">>> <br clear="none">>> On this list or on launchpad. We do not use the Github issues.<br clear="none">>> <br clear="none">>> <a shape="rect" href="https://launchpad.net/openstack-manuals" target="_blank">https://launchpad.net/openstack-manuals</a><br clear="none">> <br clear="none">> Got it. I suspect developer docs cover how patches are submitted.<br clear="none"><br clear="none">The best resource for this is the HowTo that Christian mentioned:<br clear="none"><a shape="rect" href="https://wiki.openstack.org/wiki/Documentation/HowTo" target="_blank">https://wiki.openstack.org/wiki/Documentation/HowTo</a><br clear="none"><br clear="none">You can also ask for assistance either on this mailing list, or on IRC<br clear="none">in #openstack-doc on freenode.<br clear="none"><br clear="none">> <br clear="none">>>> Finally, we are considering adding a doc guide dedicated to <br clear="none">>> OpenStack on rabbitmq.com (we have one for EC2,<br clear="none">>>> for instance). Note that we are not looking<br clear="none">>>> to replace what's on docs.openstack.org, only provide a guide <br clear="none">>> that can go into more details.<br clear="none">>>> Does this sound like a good idea to the OpenStack community? <br clear="none">>> Should we keep everything on docs.openstack.org?<br clear="none">>>> Would it be OK if we link to rabbitmq.com guides in any changes <br clear="none">>> we contribute? I don't think OpenStack Juno<br clear="none">>>> docs have a lot of external links: is that by design?<br clear="none">>> <br clear="none">>> I think it depends. It would be nice to have a working minimal guide <br clear="none">>> for<br clear="none">>> RabbitMQ inside the OpenStack documentation (as used at the <br clear="none">>> moment in<br clear="none">>> the installation guides).<br clear="none">> <br clear="none">> I agree.<br clear="none">> <br clear="none">>> Do you mean this EC2 guide: <a shape="rect" href="http://www.rabbitmq.com/ec2.html" target="_blank">http://www.rabbitmq.com/ec2.html </a> <br clear="none">>> ?<br clear="none">> <br clear="none">> That's the one, yes.<br clear="none">> <br clear="none">>> I think<br clear="none">>> such guides should be directly published on rabbitmq.com. I <br clear="none">>> can assist<br clear="none">>> while writing a guide for OpenStack.<br clear="none">> <br clear="none">> We are leaning towards this, too: have a minimalistic guide on openstack.org<br clear="none">> and link to relevant parts on rabbitmq.com, then introduce a separate guide for OpenStack<br clear="none">> users that we'll maintain.<br clear="none"><br clear="none"><br clear="none">I can only reiterate what Anne already said: we we are extremely<br clear="none">resource constrained, and I'm very wary of taking on more maintenance<br clear="none">load than we can handle. We would love to have your contributions to the<br clear="none">documentation, but new or expanded documentation needs to be very<br clear="none">carefully considered before it can be included for Liberty. I'm happy to<br clear="none">continue this conversation with you during the Liberty planning process<br clear="none">though, and would love to go through more details with you in Vancouver.<br clear="none"><br clear="none">> <br clear="none">> Thank you, folks. This has been very helpful. We'll get to work on the patches :)<br clear="none"><br clear="none">Great! Please let us know if you have any trouble :)<br clear="none"><br clear="none">Lana<br clear="none"><br clear="none">- -- <br clear="none">Lana Brindley<br clear="none">Technical Writer<br clear="none">Rackspace Cloud Builders Australia<br clear="none"><a shape="rect" href="http://lanabrindley.com/" target="_blank">http://lanabrindley.com</a><br clear="none">-----BEGIN PGP SIGNATURE-----<br clear="none">Version: GnuPG v1<br clear="none"><br clear="none">iQEcBAEBAgAGBQJVQBZvAAoJELppzVb4+KUyC3gH/RO5+sIQjo/HAOYda4y58eo4<br clear="none">9fQT3uWXMfHZZKo7DoCnsiOP/7qdqLdLzmVaKGW7xFei7hyOuhqKm11qV1psYr4N<br clear="none">8n/QsztDKE8BTr4kHas0gcJurHQLQMM+3NTv3EsykREH1nHmRhNwRRQlfPpq8e7p<br clear="none">bNLJcBJGsIDvRuuJgACwANpn0lxHLUdr4xWF9q9q9QnHX44KQJrUbcJjg2ky6XLT<br clear="none">z+PTtOUZLR1TE0q1t6KdGzxBmAY7Fg3vMhUMeUUKw5qHGmOP3M25OPNGQ9mybMBR<br clear="none">ixyLU3Y70mBM5GGEmn7rPSVC3PdYVOdJoAZDLp7g8nhYg/jvyTBvW0wc3OpA0/o=<br clear="none">=gtMG<br clear="none">-----END PGP SIGNATURE-----<div class="qtdSeparateBR"><br><br></div><div class="yqt9831270216" id="yqtfd89001"><br clear="none"><br clear="none">_______________________________________________<br clear="none">OpenStack-docs mailing list<br clear="none"><a shape="rect" ymailto="mailto:OpenStack-docs@lists.openstack.org" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br clear="none"><a shape="rect" 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 clear="none"></div><br><br></div> </div> </div> </blockquote> </div></body></html>