[Doc-SIG] Translating sample programs in documentation
Nick Coghlan
ncoghlan at gmail.com
Wed Apr 18 05:43:10 EDT 2018
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
More information about the Doc-SIG
mailing list