Re: [Doc-SIG] Make code blocks translatable

2020-01-27 Thread Maciek Olko
Thank you for response. I guess the tutorial is my main concern, because it especially (and maybe only (?)) contains some documentation sentences in comments. Having those translated would make a final step to native translated look and feel of tutorial. Would it be potentially possible to treat

Re: [Doc-SIG] Make code blocks translatable

2020-01-26 Thread Inada Naoki
I don't have a strong objection, but I think translating sample code is much less important than translating regular docs. For example, see https://docs.python.org/3/library/functools.html There are many example code blocks. Translating strings in them doesn't help much. So I think focusing to r

[Doc-SIG] Make code blocks translatable

2020-01-25 Thread Maciek Olko
Hello, I'd like to set up discussion about making code blocks in documentation translatable. From my experience many of code blocks would benefit from being translated. Especially comments and string literals. For example this code block from tutorial: # this is the first commentspam = 1 # and t