[Doc-SIG] Translating sample programs in documentation

INADA Naoki songofacandy at gmail.com
Wed Apr 18 06:06:46 EDT 2018


> IMO it's almost impossible to verify if this practice is generally better for beginners or not, without actually trying it out in limited scope, like the official tutorial.
>
> To clarify, I'm not pushing other languages to do the same.
>

How about starting it other than docs.python.org, as your personal project?

There is no option for "exporting code only for these files" option in
Sphinx currently.
And if we include example codes in message files, all languages are
affected, at least on the Transifex.

I feel your motivation is just you want to promote non-ASCII identifier.
And I think the cost required to do it on the docs.python.org is too much.
But trying it on other site must be much easier.

If you demonstrates benefits of non-ASCII identifier and Chinese translation
team really want it on the docs.python.org, I'm pleasure to think about it.

But as far as it's just your personal preference, I don't want to push
example codes to Transifex.

Regards,

-- 
INADA Naoki  <songofacandy at gmail.com>


More information about the Doc-SIG mailing list