Hi Julien,
thank you for the clear explanation.
On Tue, Oct 15, 2019 at 6:15 AM Julien Palard <jul...@palard.fr> wrote:
>
> > I have several questions before I continue the process:
> >
> > 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?
>
> PEP 545 wins, I'll fix the devguide, thanks for noticing.
>
> great, hope it will encourage more team to comply with PEP 545.
> > b. I saw on Python's github repo, many python-doc-{LANG} hosted there,
> how to request `python-doc-id` on that repository?
>
> 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.
> If you choose to transfer the repository it's a two step process:
> - First transfer it to me (github.com/JulienPalard), trust me I'm the PEP
> 545 author I won't steal the repo :]
> - Then I'll transfer it to the Python organization.
>
> I have transferred the 'python-docs-id' repository to your account. please
don't steal it. :D
I will wait for the repository available on python organization. \o/
> > c. Is it mandatory to have reviewer on Transifex? I saw not many
> languages doing reviews on the translation there.
>
> 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].
>
> hm, it's very good example. will gather more people to work on it.
> > d. and what to do next, if I have completed the translations (a), to be
> included on language switcher?
>
> Once the repository migrated, open a PR to add your language here:
> https://github.com/python/docsbuild-scripts/blob/master/build_docs.py#L62
>
> It will build your doc on the server and make it available on
> docs.python.org so you can check if everything's OK before opening to the
> public.
>
> If everything renders correctly you'll have to open another pull request
> to add your language to the switcher here:
> https://github.com/python/cpython/blob/master/Doc/tools/static/switchers.js#L21
>
> I will do this part later, I think I need to test build with
'docsbuild-scripts' first at a local machine.
--
sincerely,
oon arfiandwi
_______________________________________________
Doc-SIG maillist - Doc-SIG@python.org
https://mail.python.org/mailman/listinfo/doc-sig
