<div dir="ltr"><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote">At the moment I am not sure if I like it or not. But I think the usage 
of custom RST directives should be discussed on the list and if we 
decide to use custom RST directives they should be documented in the 
contributor guide.<br></blockquote><div><br></div><div>I think it makes sense to add this directive to the Contributor Guide (not to copy and paste files to the repository and then update them manually).<br><br></div><div>Maria<br> </div></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Dec 2, 2015 at 2:45 PM, Olena Logvinova <span dir="ltr"><<a href="mailto:ologvinova@mirantis.com" target="_blank">ologvinova@mirantis.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"><span class=""><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></span><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"><div><div class="h5"><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>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><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><div><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></div></div><span class="HOEnZb"><font color="#888888">-- <br><div><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>
</font></span></div></div></div>
<br>_______________________________________________<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" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></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"><span style="color:rgb(102,102,102)"><span style="font-family:arial,helvetica,sans-serif"><span style="color:rgb(0,0,0)">Mariia Zlatkova</span></span><span style="color:rgb(68,68,68)"><br><span style="color:rgb(102,102,102)">Technical Writer | <span style="font-size:10pt;font-family:"Arial",sans-serif">Mirantis, Kharkiv</span></span></span></span><span style="color:rgb(102,102,102)"><span style="color:rgb(68,68,68)"><span style="color:rgb(102,102,102)"><span style="font-size:10pt;font-family:"Arial",sans-serif"><br></span><span style="font-size:10pt;font-family:"Arial",sans-serif"></span><a href="http://www.mirantis.com" target="_blank">www.mirantis.com</a><br><br></span></span></span><span></span></div></div></div></div></div></div></div></div>
</div>