-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA256 How will it impact translation? L On 02/12/15 23:21, Mariia Zlatkova wrote:

...

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.

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).

Maria

On Wed, Dec 2, 2015 at 2:45 PM, Olena Logvinova <ologvinova@mirantis.com> wrote:

...

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.

I like the way a document looks like if we use this directive - it becomes smaller and, therefore, looks nicer. =) So I vote for adding this directive to the Contributor Guide conventions.

Thanks Olena

On Wed, Dec 2, 2015 at 1:17 PM, Gauvain Pocentek < gauvain.pocentek@objectif-libre.com> wrote:

...

Le 2015-12-02 11:31, Christian Berendt a écrit :

...

Hello everybody.

While reviewing a review request for the new config-rst-guide I saw the usage of the RST directive "remote-code-block". I never saw this directive before and after searching for the definition I only found

https://github.com/openstack/openstack-manuals/blob/master/doc/config-ref-rs... .

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.

...

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.

Agreed. To be honnest I planned to write to the ML but it just slipped my mind.

Gauvain Pocentek

Objectif Libre - Infrastructure et Formations Linux http://www.objectif-libre.com

_______________________________________________ OpenStack-docs mailing list OpenStack-docs@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

-- Best regards, Olena Logvinova, Technical Writer | Mirantis, Kharkiv | 38, Lenin av., Kharkiv ologvinova@mirantis.com | +380950903196

_______________________________________________ OpenStack-docs mailing list OpenStack-docs@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

_______________________________________________ OpenStack-docs mailing list OpenStack-docs@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

- -- Lana Brindley Technical Writer Rackspace Cloud Builders Australia http://lanabrindley.com -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iQEcBAEBCAAGBQJWX3PhAAoJELppzVb4+KUyD5IIAI78AYaDM00xzv1rmSyd7Pg1 3p0NrvZD2BtLPEiCq42B5DRWf2XNNnzbFGyqWvyT8ShD/94pr+5ASGceKv5t8P7H Rn0Gkc6idGKsv53ZKxWRHwizCm8mt+3VPiOQYZYhK4ghFII/mBY8kYNwnRQyyYHv rU5tdLNqOAlq36WqmVVbOUh0C3Rf3+YPs3BjcWNnnqVx11C/tPYJ5LR7oNHxW3jJ ZP0wZe9i/+6yOtH5dDxj0k4WnwXvdfXQPIAlHbpY1FvJUl8vsRMxrEe7s10AmpTS D2UybNqPg79PBdg7CUX6c72r+ASPw+LZTJeJm3vVpWY4izpmezZWt30drEUIgkU= =gnC5 -----END PGP SIGNATURE-----