<div dir="ltr"><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">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.</blockquote><div><br></div><div>I like the way a document looks like if we use this directive - it becomes smaller and, therefore, looks nicer. =)</div><div>So I vote for adding this directive to the Contributor Guide conventions.</div><div><br></div><div>Thanks</div><div>Olena<br><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Dec 2, 2015 at 1:17 PM, 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: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="">Le 2015-12-02 11:31, Christian Berendt a écrit :<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">
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>
<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>
</blockquote>
<br></span>
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.<span class=""><br>
<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">
<br>
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></span>
Agreed. To be honnest I planned to write to the ML but it just slipped my mind.<br>
<br>
<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><div class=""><div class="h5"><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"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div>Best regards,</div>Olena Logvinova,<div>Technical Writer | Mirantis, Kharkiv | 38, Lenin av., Kharkiv</div><div><a href="mailto:ologvinova@mirantis.com" style="color:rgb(17,85,204)" target="_blank">ologvinova@mirantis.com</a> | <a href="tel:%2B380950903196" value="+380669377102" style="color:rgb(17,85,204)" target="_blank">+380950903196</a></div></div></div>
</div></div></div>