<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Jun 19, 2020 at 7:25 PM Juan Luis Cano <<a href="mailto:juanlu001@gmail.com">juanlu001@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">You might want to checkout what CPython is doing for their docs, using<br>
gettext and plain pull requests (i.e. no Transifex):<br></blockquote><div><br></div><div>Spyder has just moved from such an approach to Crowdin, and are way happier with the latter. I think PRs for translations is a bad idea in 2020, both because translators should have a UI that works for them rather than a dev-centric workflow, and because it's less effort with integration for the maintainers.</div><div><br></div><div>We have found the same with doc/tutorial writing - Sphinx + PRs is terrible, tech writers much prefer something like a notebook. <br></div><div><br></div><div>Thanks for the suggestion though Juan Luis.</div><div><br></div><div>Cheers,<br></div><div>Ralf</div><div><br></div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
<a href="https://github.com/python/python-docs-es" rel="noreferrer" target="_blank">https://github.com/python/python-docs-es</a><br>
<br>
On 6/19/20, Ralf Gommers <<a href="mailto:ralf.gommers@gmail.com" target="_blank">ralf.gommers@gmail.com</a>> wrote:<br>
> On Fri, Jun 19, 2020 at 6:45 PM Ralf Gommers <<a href="mailto:ralf.gommers@gmail.com" target="_blank">ralf.gommers@gmail.com</a>><br>
> wrote:<br>
><br>
>> Hi Luis, welcome<br>
>><br>
>><br>
>> On Thu, Jun 18, 2020 at 6:47 PM Matt Haberland <<a href="mailto:mhaberla@calpoly.edu" target="_blank">mhaberla@calpoly.edu</a>><br>
>> wrote:<br>
>><br>
>>> These are just my thoughts; someone who has been around longer will<br>
>>> likely know more, but it might take longer to get that response.<br>
>>><br>
>>> It looks like Sphinx (our documentation system) supports<br>
>>> internationalization<br>
>>> <<a href="https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#using-transifex-service-for-team-translation" rel="noreferrer" target="_blank">https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#using-transifex-service-for-team-translation</a>><br>
>>> and<br>
>>> there are services (e.g. Transifex <<a href="https://www.transifex.com/" rel="noreferrer" target="_blank">https://www.transifex.com/</a>>) that<br>
>>> make crowdsourcing easier. The difficult part is probably building a<br>
>>> team<br>
>>> that will review one another's work and maintain the translations as the<br>
>>> English documentation changes. I imagine that users of the documentation<br>
>>> might also want to file bug reports in Spanish, but that might be more<br>
>>> difficult to support.<br>
>>><br>
>>> > Is there a project already that is translating the documentation into<br>
>>> Spanish so that I can join?<br>
>>> I don't know of existing projects, but others might have a better idea<br>
>>> of<br>
>>> the history.<br>
>>><br>
>>> > What kind of qualifications do I need? (I have already translated some<br>
>>> technical books for my own learning and entertainment.)<br>
>>> Probably the ones you have, then. Anyone can contribute to the English<br>
>>> documentation, and changes are reviewed for quality by maintainers<br>
>>> before<br>
>>> inclusion in SciPy. I suppose that the same would be true of Spanish<br>
>>> translations, except there would need to be a team of translation<br>
>>> maintainers.<br>
>>><br>
>>> > How do I start? Do I just start translating? If so, when I have<br>
>>> something finished who do I send it to?<br>
>>> Unless there is an existing project, someone will need to research how<br>
>>> to<br>
>>> manage this sort of project before actual translations could be used.<br>
>>> I'd suggest contributing to SciPy's English documentation<br>
>>> <<a href="https://github.com/scipy/scipy/issues?q=is%3Aopen+is%3Aissue+label%3ADocumentation" rel="noreferrer" target="_blank">https://github.com/scipy/scipy/issues?q=is%3Aopen+is%3Aissue+label%3ADocumentation</a>><br>
>>> first, and meanwhile, maybe contribute to the Sphinx documentation<br>
>>> translation <<a href="https://www.transifex.com/sphinx-doc/sphinx-doc/" rel="noreferrer" target="_blank">https://www.transifex.com/sphinx-doc/sphinx-doc/</a>> to see<br>
>>> how that process works. Then I would suggest writing up your thoughts on<br>
>>> how a SciPy documentation translation project might be organized and how<br>
>>> it<br>
>>> could work technically in order to produce and maintain high-quality<br>
>>> translations.<br>
>>><br>
>><br>
>> I think translating the SciPy docs isn't the best place to start, because<br>
>> it's an enormous task. Here is what I wrote for the NumPy website, which<br>
>> I<br>
>> think is a good place to start and needs both working out a few kinks in<br>
>> the workflow and doing the translation in some of the most-used languages<br>
>> (including Spanish):<br>
>><br>
><br>
> Sorry, sent too early.<br>
><br>
> <a href="https://numpy.org/neps/nep-0028-website-redesign.html#translation-multilingual-i18n" rel="noreferrer" target="_blank">https://numpy.org/neps/nep-0028-website-redesign.html#translation-multilingual-i18n</a><br>
> <a href="https://github.com/numpy/numpy.org/issues/55" rel="noreferrer" target="_blank">https://github.com/numpy/numpy.org/issues/55</a><br>
><br>
> Now that that website is launched, translations can be tackled.<br>
><br>
> For SciPy, we should do something similar after that (assuming for NumPy<br>
> it's successful) - start with the most high-level content.<br>
><br>
> Cheers,<br>
> Ralf<br>
><br>
><br>
><br>
>><br>
>>> On Wed, Jun 17, 2020 at 3:56 PM Luis Lozano <<a href="mailto:luis9699@live.com.mx" target="_blank">luis9699@live.com.mx</a>><br>
>>> wrote:<br>
>>><br>
>>>> Hello, My name is Luis E. Lozano Marrujo.<br>
>>>><br>
>>>><br>
>>>><br>
>>>> I am a native Spanish speaker who is interested in helping to translate<br>
>>>> some (most of that which I can translate) of the documentation into<br>
>>>> Spanish. And I have some doubts:<br>
>>>><br>
>>>><br>
>>>><br>
>>>> Is there a project already that is translating the documentation into<br>
>>>> Spanish so that I can join?<br>
>>>><br>
>>>> What kind of qualifications do I need? (I have already translated some<br>
>>>> technical books for my own learning and entertainment.)<br>
>>>><br>
>>>> How do I start? Do I just start translating? If so, when I have<br>
>>>> something finished who do I send it to?<br>
>>>><br>
>>>><br>
>>>><br>
>>>><br>
>>>><br>
>>>> Thanks for the attention and help. Also much thanks to all the people<br>
>>>> who develop this stuff!<br>
>>>><br>
>>>> _______________________________________________<br>
>>>> SciPy-Dev mailing list<br>
>>>> <a href="mailto:SciPy-Dev@python.org" target="_blank">SciPy-Dev@python.org</a><br>
>>>> <a href="https://mail.python.org/mailman/listinfo/scipy-dev" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/scipy-dev</a><br>
>>>><br>
>>><br>
>>><br>
>>> --<br>
>>> Matt Haberland<br>
>>> Assistant Professor<br>
>>> BioResource and Agricultural Engineering<br>
>>> 08A-3K, Cal Poly<br>
>>> _______________________________________________<br>
>>> SciPy-Dev mailing list<br>
>>> <a href="mailto:SciPy-Dev@python.org" target="_blank">SciPy-Dev@python.org</a><br>
>>> <a href="https://mail.python.org/mailman/listinfo/scipy-dev" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/scipy-dev</a><br>
>>><br>
>><br>
><br>
<br>
<br>
-- <br>
Juan Luis Cano<br>
_______________________________________________<br>
SciPy-Dev mailing list<br>
<a href="mailto:SciPy-Dev@python.org" target="_blank">SciPy-Dev@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/scipy-dev" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/scipy-dev</a><br>
</blockquote></div></div>