<div dir="ltr"><div><div><div>Gauvain,<br></div><br></div>This is the most appropriate place <a href="http://docs.openstack.org/contributor-guide/rst-conv/source-code.html">http://docs.openstack.org/contributor-guide/rst-conv/source-code.html</a><br><br></div>Olga<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Dec 3, 2015 at 9:20 AM, Gauvain Pocentek <span dir="ltr"><<a href="mailto:gauvain.pocentek@objectif-libre.com" target="_blank">gauvain.pocentek@objectif-libre.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><br>
<br>
Le 2015-12-02 13:45, Olena Logvinova a écrit :<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
At the moment I am not sure if I like it or not. But I think the<br>
usage of custom RST directives should be discussed on the list and if<br>
we decide to use custom RST directives they should be documented in<br>
the contributor guide.<br>
</blockquote>
<br>
I like the way a document looks like if we use this directive - it<br>
becomes smaller and, therefore, looks nicer. =)<br>
So I vote for adding this directive to the Contributor Guide conventions.<br>
</blockquote>
<br>
<br></span>
I'm not yet familiar with the contributor guide. Where do you suggest I should add this?<br>
<br>
Thanks,<br>
Gauvain<br>
<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
<br>
Thanks<br>
Olena<br>
<br>
On Wed, Dec 2, 2015 at 1:17 PM, Gauvain Pocentek<br>
<<a href="mailto:gauvain.pocentek@objectif-libre.com" target="_blank">gauvain.pocentek@objectif-libre.com</a>> wrote:<br>
<br>
</span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
Le 2015-12-02 11:31, Christian Berendt a écrit :<br>
<br>
</span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">
Hello everybody.<br>
<br>
While reviewing a review request for the new config-rst-guide I saw<br>
the usage of the RST directive "remote-code-block". I never saw this<br>
directive before and after searching for the definition I only found<br>
</span><a href="https://github.com/openstack/openstack-manuals/blob/master/doc/config-ref-rst/source/ext/remote.py#L19" rel="noreferrer" target="_blank">https://github.com/openstack/openstack-manuals/blob/master/doc/config-ref-rst/source/ext/remote.py#L19</a> [1].<br>
</blockquote><span class="">
<br>
This particular directive tries to reproduce the docbook <xi:include> behaviour, to avoid adding loads of sample file in our tree. I'm guilty of adding it to the config-ref-rst folder.<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
At the moment I am not sure if I like it or not. But I think the<br>
usage of custom RST directives should be discussed on the list and if<br>
we decide to use custom RST directives they should be documented in<br>
the contributor guide.<br>
</blockquote>
<br>
Agreed. To be honnest I planned to write to the ML but it just slipped my mind.<br>
<br>
Gauvain Pocentek<br>
<br>
Objectif Libre - Infrastructure et Formations Linux<br>
</span><a href="http://www.objectif-libre.com" rel="noreferrer" target="_blank">http://www.objectif-libre.com</a> [2]<span class=""><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>
</span><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> [3]<br>
</blockquote>
<br>
--<br>
<br>
Best regards,Olena Logvinova,<span class=""><br>
Technical Writer | Mirantis, Kharkiv | 38, Lenin av., Kharkiv<br>
</span><a href="mailto:ologvinova@mirantis.com" target="_blank">ologvinova@mirantis.com</a> | <a href="tel:%2B380950903196" value="+380950903196" target="_blank">+380950903196</a> [4]<br>
<br>
Links:<br>
------<br>
[1]<br>
<a href="https://github.com/openstack/openstack-manuals/blob/master/doc/config-ref-rst/source/ext/remote.py#L19" rel="noreferrer" target="_blank">https://github.com/openstack/openstack-manuals/blob/master/doc/config-ref-rst/source/ext/remote.py#L19</a><br>
[2] <a href="http://www.objectif-libre.com" rel="noreferrer" target="_blank">http://www.objectif-libre.com</a><br>
[3] <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>
[4] tel:%2B380950903196<br>
</blockquote><div class="HOEnZb"><div class="h5">
<br>
Gauvain Pocentek<br>
<br>
Objectif Libre - Infrastructure et Formations Linux<br>
<a href="http://www.objectif-libre.com" rel="noreferrer" target="_blank">http://www.objectif-libre.com</a><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="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>
</div></div></blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div><span style="color:rgb(102,102,102)">Best regards,<br></span></div><span style="color:rgb(102,102,102)">Olga Gusarenko<br><br></span></div><span style="color:rgb(102,102,102)">Technical Writer<span><span> | Mirantis, Kharkiv | 38, Lenin av., Kharkiv, Ukraine<br></span></span></span><div><span style="color:rgb(102,102,102)"><a href="mailto:ogusarenko@mirantis.com" target="_blank">ogusarenko@mirantis.com</a> <span><span>| </span></span>skype: gusarenko.olga <span><span>| +38 (050) 843-14-25</span></span><span><span></span></span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div>
</div>