<div dir="ltr"><div dir="ltr"><br></div><div>Hi Julien,</div><div>thank you for the clear explanation.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Oct 15, 2019 at 6:15 AM Julien Palard <<a href="mailto:julien@palard.fr">julien@palard.fr</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"><br>
> I have several questions before I continue the process:<br>
><br>
> a. according to devguide site [2], I need to finish `library/stdtypes` too, but it is not mentioned on (current PEP 545). can someone help me to clarify which one is the minimum?<br>
<br>
PEP 545 wins, I'll fix the devguide, thanks for noticing.<br>
<br></blockquote><div>great, hope it will encourage more team to comply with PEP 545.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> b. I saw on Python's github repo, many python-doc-{LANG} hosted there, how to request `python-doc-id` on that repository?<br>
<br>
You can either transfer the repository to the python organization (clean way I think) or ask me to create one on the python organization and give you permissions on it.<br>
If you choose to transfer the repository it's a two step process:<br>
- First transfer it to me (<a href="http://github.com/JulienPalard" rel="noreferrer" target="_blank">github.com/JulienPalard</a>), trust me I'm the PEP 545 author I won't steal the repo :]<br>
- Then I'll transfer it to the Python organization.<br>
<br></blockquote><div>I have transferred the 'python-docs-id' repository to your account. please don't steal it. :D</div><div>I will wait for the repository available on python organization. \o/</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>
> c. Is it mandatory to have reviewer on Transifex? I saw not many languages doing reviews on the translation there.<br>
<br>
That's not mandatory, yet if you want a good quality I think reviewing is a good step. In France we don't use Transfiex because we're using github pull requests to proofread a lot, and a lot of mistakes are catched at this step [2].<br>
<br></blockquote><div>hm, it's very good example. will gather more people to work on it.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
> d. and what to do next, if I have completed the translations (a), to be included on language switcher?<br>
<br>
Once the repository migrated, open a PR to add your language here: <a href="https://github.com/python/docsbuild-scripts/blob/master/build_docs.py#L62" rel="noreferrer" target="_blank">https://github.com/python/docsbuild-scripts/blob/master/build_docs.py#L62</a><br>
<br>
It will build your doc on the server and make it available on <a href="http://docs.python.org" rel="noreferrer" target="_blank">docs.python.org</a> so you can check if everything's OK before opening to the public.<br>
<br>
If everything renders correctly you'll have to open another pull request to add your language to the switcher here: <a href="https://github.com/python/cpython/blob/master/Doc/tools/static/switchers.js#L21" rel="noreferrer" target="_blank">https://github.com/python/cpython/blob/master/Doc/tools/static/switchers.js#L21</a><br>
<br></blockquote><div>I will do this part later, I think I need to test build with 'docsbuild-scripts' first at a local machine.</div><div><br></div><div>-- </div><div>sincerely,</div><div>oon arfiandwi</div><div><br></div><div> </div></div></div>