<div dir="ltr"><div dir="ltr">Hi Julien,<div>contributors has to sign the <a href="https://www.python.org/psf/contrib/contrib-form/">https://www.python.org/psf/contrib/contrib-form/</a> ?</div><div>How can I collect them using github? Are there any bots you recommend?</div><div>Another question: can I add a file to the repo to list contributors' names? </div><div>Thanks</div><div><br clear="all"><div><div dir="ltr" class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><b style="color:rgb(51,51,51);font-family:Arial,Helvetica,sans-serif;font-size:14px">Alessandro Cucci</b></div></div></div></div></div></div></div></div><br></div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Il giorno dom 21 apr 2019 alle ore 19:23 Alessandro Cucci <<a href="mailto:alessandro.cucci@gmail.com">alessandro.cucci@gmail.com</a>> ha scritto:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div dir="ltr">Thanks so much Julien!</div><div dir="ltr">> Looks like there's two main ways of translating the Python documentation: git-centric or external-tool centric.<br><div>Since I'm a developer, I'll choose the git-centric way!</div><div><br></div><div>> If you choose the gitub workflow, there's a cookiecutter (<a href="https://github.com/JulienPalard/python-docs-cookiecutter" rel="noreferrer" target="_blank">https://github.com/JulienPalard/python-docs-cookiecutter</a>) to bootstrap it</div><div>Soo easy, thanks!</div><div><br></div><div>> create the github repo (named python-docs-it)</div><div>Done: <a href="https://github.com/alessandrocucci/python-docs-it" target="_blank">https://github.com/alessandrocucci/python-docs-it</a></div><div><br></div><div>> gather people around the translation</div><div>This is harder, but I have faith in the community</div><div><br></div><div>For now, this is enough to get started. I'll play with poedit cause i've never used it before and of course I'll keep you updated.</div><div><br></div><div><br clear="all"><div><div dir="ltr" class="gmail-m_-4717544805411075280m_-2971621598094193400gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><b style="color:rgb(51,51,51);font-family:Arial,Helvetica,sans-serif;font-size:14px">Alessandro Cucci</b></div></div></div></div></div></div></div></div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Il giorno dom 21 apr 2019 alle ore 17:38 Julien Palard <<a href="mailto:julien@palard.fr" target="_blank">julien@palard.fr</a>> ha scritto:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Alessandro!<br>
<br>
> I want to start a project for translating the Python Documentation in Italian.<br>
<br>
\o/<br>
<br>
> Is there anybody who can help me to start?<br>
<br>
I'm the author of the PEP 545, so I should be able to help.<br>
<br>
Looks like there's two main ways of translating the Python documentation: git-centric or external-tool centric.<br>
<br>
Most countries are going "external tool centric", and most if not all are using transifex here: <a href="https://www.transifex.com/python-doc/public/" rel="noreferrer" target="_blank">https://www.transifex.com/python-doc/public/</a><br>
<br>
You're free to choose another tool, there's very few rules around this:<br>
- From time to time (automatically the better) sync to github so we can pull from it to build the docs on <a href="http://docs.python.org" rel="noreferrer" target="_blank">docs.python.org</a>, github is our "meet point".<br>
- Put the contributions under CC0 (see <a href="https://www.python.org/dev/peps/pep-0545/#setup-the-documentation-contribution-agreement" rel="noreferrer" target="_blank">https://www.python.org/dev/peps/pep-0545/#setup-the-documentation-contribution-agreement</a>)<br>
<br>
France (my country) is doing "github centric", meaning we're only accepting pull requests on github, see our repo here: <a href="https://github.com/python/python-docs-fr/pulls" rel="noreferrer" target="_blank">https://github.com/python/python-docs-fr/pulls</a><br>
<br>
I like the github workflow for some reasons:<br>
- We can give feedback on a contributor basis as pull request comments, and merge only when the quality is the one expected.<br>
- Contributing to the docs means learning git, command line, cooperation in github, and so on. It's a door to do PR on other open source projects (like cpython upstream documentation), and sometimes translators in workshops are telling us "I did not translated much today, but I learnt a lot, thank you for this", and I like this.<br>
<br>
If you choose the gitub workflow, there's a cookiecutter (<a href="https://github.com/JulienPalard/python-docs-cookiecutter" rel="noreferrer" target="_blank">https://github.com/JulienPalard/python-docs-cookiecutter</a>) to bootstrap it, if you choose to sync from transifex or another tool don't hesistate to get inspiration from other countries (<a href="http://github.com/python/python-docs-*" rel="noreferrer" target="_blank">github.com/python/python-docs-*</a> excepted fr and theme).<br>
<br>
Next steps are: create the github repo (named python-docs-it), and gather people around the translation, if it works we'll migrate your repo to <a href="http://github.com/python/" rel="noreferrer" target="_blank">github.com/python/</a>, and we'll have to nominate a coordinator for your language (typically you if you feel it).<br>
<br>
After some translations done, don't hesistate to ask me to start building the doc on <a href="http://docs.python.org" rel="noreferrer" target="_blank">docs.python.org</a> for preview purposes. And when you'll reach enough translations [1] we'll add your language to the menu.<br>
<br>
Feel free to continue this thread if you have questions, and or come asking me on IRC, I'm mdk on freenode, there's the #python-doc channel dedicated to this.<br>
<br>
[1]: <a href="https://www.python.org/dev/peps/pep-0545/#add-translation-to-the-language-switcher" rel="noreferrer" target="_blank">https://www.python.org/dev/peps/pep-0545/#add-translation-to-the-language-switcher</a><br>
-- <br>
Julien Palard<br>
<a href="https://mdk.fr" rel="noreferrer" target="_blank">https://mdk.fr</a><br>
<br>
</blockquote></div></div>
</blockquote></div>