[Doc-SIG] Translating sample programs in documentation

[Nick Coghlan]

On 18 April 2018 at 19:23, Xuan Wu <fromwheretowhere.service at gmail.com> wrote:
> Hi Julien,
>
> thanks I agree that's another option. Still IMHO there's not yet clear
> requirement about this yet. As I imagine some users might prefer the
> 'global' switcher while some others might prefer the 'local' one as you
> suggested. Could we show the translated programs by default first, and then
> improve potential usability after gathering more feedback?

If the translation of the examples in the tutorial can be handled by
the docs build process, then making this a per-translation policy
decision does sound like it would be the simplest near term approach.

As Xuan notes, if folks following a translation with translated
examples also want to look at the English language examples, they'll
always be able to switch back to the English translation of the
tutorial.

Cheers,
Nick.

-- 
Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia