[Openstack-i18n] [OpenStack-docs] Code block in RST and translation

Andreas Jaeger aj at suse.com
Wed Nov 25 14:54:37 UTC 2015


On 2015-11-25 15:48, KATO Tomoyuki wrote:
>>
>>> On 25 Nov 2015, at 03:41, KATO Tomoyuki <tomo at dream.daynight.jp> wrote:
>>>
>>>> My idea at now is to use "code-block" directive as possible as we can,
>>>
>>> As far as I know, docs team guides mainly use "code-block".
>>> So, I'm okay to unify to "code-block" directive.
>>>
>>>> but I am not sure it is the right direction as "::" is widely used.
>>>
>>> In my understand, most of developers like “::”, which is simple RST format :)
>>
>> Maybe we could add a gate check that looks for “::” in the end of the strings (original and translated)? It would enable developers to use whatever they are used to.
> 
> Nice idea! Sounds good to me, as a non-vote job.
> 
> Regards,
> KATO Tomoyuki

But who will monitor this and correct it?

We already see warnings in translated code that everybody ignores, let's
find a good way to monitor and fix these problems first before we add
more tests...

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,
       HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126




More information about the Openstack-i18n mailing list