<div dir="ltr"><div><div>Matt, thank you for the feedback!<br><span dir="auto"><br>The Documentation/ReviewGuidelines</span> [1] was not included in the spec, the conversion part. But we are referring to it in the Reviewing documentation section [2] of the Contributor guide.<br></div>We can convert it in the next iteration.<br><br></div>As to the RST build processes. We have this change on review, please see [3].<br><div><div><br>[1] <a href="https://wiki.openstack.org/wiki/Documentation/ReviewGuidelines" target="_blank">https://wiki.openstack.org/wiki/Documentation/ReviewGuidelines</a><br>[2] <a href="http://docs-draft.openstack.org/96/231996/5/gate/gate-openstack-manuals-tox-doc-publish-checkbuild/187b59d//publish-docs/draft/contributor-guide/docs-review.html">http://docs-draft.openstack.org/96/231996/5/gate/gate-openstack-manuals-tox-doc-publish-checkbuild/187b59d//publish-docs/draft/contributor-guide/docs-review.html</a><br>[3] <a href="https://review.openstack.org/#/c/234320/1/doc/contributor-guide/source/build-locally.rst">https://review.openstack.org/#/c/234320/1/doc/contributor-guide/source/build-locally.rst</a></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Oct 13, 2015 at 3:45 PM, Matt Kassawara <span dir="ltr"><<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Looks good! A few questions...<div><br></div><div>Do you plan to incorporate the review guidelines currently in the wiki [1]?<div><div><br></div><div><div><a href="https://wiki.openstack.org/wiki/Documentation/ReviewGuidelines" target="_blank">https://wiki.openstack.org/wiki/Documentation/ReviewGuidelines</a></div></div></div></div><div><br></div><div>What about including RST build processes in the builds section?</div></div><div class="gmail_extra"><br><div class="gmail_quote"><div><div class="h5">On Tue, Oct 13, 2015 at 2:30 AM, Olga Gusarenko <span dir="ltr"><<a href="mailto:ogusarenko@mirantis.com" target="_blank">ogusarenko@mirantis.com</a>></span> wrote:<br></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5"><div dir="ltr"><div>Thanks much for your replies, we will proceed as discussed.<br><br></div><div>Best, Olga<br> <br></div><br></div><div class="gmail_extra"><div><div><br><div class="gmail_quote">On Mon, Oct 12, 2015 at 3:18 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"><span>On 2015-10-12 13:43, Olga Gusarenko wrote:<br>
</span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>
Hi all,<br>
<br>
The Contributor guide is almost ready to be published.<br>
<br>
We have several commits on review at the moment. They are:<br>
<br></span>
* <a href="https://review.openstack.org/#/c/232966/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/232966/</a><br>
* <a href="https://review.openstack.org/#/c/233183/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/233183/</a><br>
* some information from the HowTo conventions page will be available<span><br>
on review in a day.<br>
<br></span>
*Your reviews are welcome.*<br>
</blockquote>
><br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>
Therefore, we would like to know the next steps to take to have the<br>
guide published.<br>
<br></span>
>> /Andreas suggests the following solutions/:<span><br>
>> On a technical level: Update tools/build-all-rst.sh so that it does<br>
not get published at /draft/ and update all index.html pages.<br>
>> On a process level: Once those changes are in, I suggest we do a one<br>
week review of the content (still as draft) and afterwards to the<br>
technical change.<br>
>> We do not need to wait for Liberty, we can publish and announce<br>
anytime we think we're ready.<br>
</span></blockquote>
<br>
<br>
One addition: Once you have everything in, rework the wiki pages so that they are empty and just link/redirect to the new contributor guide.<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>
Another question is about DocBook markup. I suggest leaving the related<br>
conventions as they are (on wiki), and create a separate page in the<br>
Contributor guide with the information that the DocBook markup is<br>
deprecated at the moment but if users need it they can refer<br>
tohttps://<a href="http://wiki.openstack.org/wiki/Documentation/Markup_conventions" rel="noreferrer" target="_blank">wiki.openstack.org/wiki/Documentation/Markup_conventions</a><br></span>
<<a href="https://wiki.openstack.org/wiki/Documentation/Markup_conventions" rel="noreferrer" target="_blank">https://wiki.openstack.org/wiki/Documentation/Markup_conventions</a>>.<br>
What do you think?<br>
<br>
>> /from Andreas/:<br>
>>Works for me.<br>
<br>
*Your thoughts and ideas regarding the matter are very much appreciated!*<span><font color="#888888"><br>
</font></span></blockquote><span><font color="#888888">
<br>
Andreas<br>
-- <br>
Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
HRB 21284 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
<br>
</font></span></blockquote></div><br><br clear="all"><br></div></div><span>-- <br><div><div dir="ltr"><div><div>Best regards,<br></div>Olga<br><br></div>Technical Writer<br><div>skype: gusarenko.olga
</div><div><br></div></div></div>
</span></div>
<br></div></div><span class="">_______________________________________________<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="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></span></blockquote></div><br></div>
</blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div><div>Best regards,<br></div>Olga<br><br></div>Technical Writer<br><div>skype: gusarenko.olga
</div><div><br></div></div></div>
</div>