Re: Translating sample programs in documentation
Nick Coghlan <[email protected]> Wed, 18 Apr 2018 19:43:10 +1000
| Newsgroups | gmane.comp.python.documentation |
|---|---|
| Message-ID | <CADiSq7ekqFKmdQDf_=OHRo_7_Qabn6s7gG56bt8Ue_B5se1bEA@mail.gmail.com> |
On 18 April 2018 at 19:23, Xuan Wu <[email protected]> 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 | [email protected] | Brisbane, Australia _______________________________________________ Doc-SIG maillist - [email protected] https://mail.python.org/mailman/listinfo/doc-sig