Re: Python Documentation Translation to Bahasa Indonesia (Indonesian Language)

--===============8477006117821363690==
Content-Type: multipart/alternative; boundary="000000000000c7f7e70594eec034"

--000000000000c7f7e70594eec034
Content-Type: text/plain; charset="UTF-8"

Hi Julien,
thank you for the clear explanation.

On Tue, Oct 15, 2019 at 6:15 AM Julien Palard <[email protected]> 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

--000000000000c7f7e70594eec034
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><br></div><div>Hi Julien,</div><div>thank=
 you for the clear explanation.</div><br><div class=3D"gmail_quote"><div di=
r=3D"ltr" class=3D"gmail_attr">On Tue, Oct 15, 2019 at 6:15 AM Julien Palar=
d &lt;<a href=3D"mailto:[email protected]">[email protected]</a>&gt; wrote:<b=
r></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex=
;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
&gt; I have several questions before I continue the process:<br>
&gt;<br>
&gt; 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&#39;ll fix the devguide, thanks for noticing.<br>
<br></blockquote><div>great, hope it will encourage more team to comply wit=
h PEP 545.</div><div>=C2=A0</div><blockquote class=3D"gmail_quote" style=3D=
"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-le=
ft:1ex">
&gt; b. I saw on Python&#39;s github repo, many python-doc-{LANG} hosted th=
ere, how to request `python-doc-id` on that repository?<br>
<br>
You can either transfer the repository to the python organization (clean wa=
y 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&#39;s a two step process:<br>
- First transfer it to me (<a href=3D"http://github.com/JulienPalard" rel=
=3D"noreferrer" target=3D"_blank">github.com/JulienPalard</a>), trust me I&=
#39;m the PEP 545 author I won&#39;t steal the repo :]<br>
- Then I&#39;ll transfer it to the Python organization.<br>
<br></blockquote><div>I have transferred the &#39;python-docs-id&#39; repos=
itory to your account. please don&#39;t steal it. :D</div><div>I will wait =
for the repository available on python organization. \o/</div><div><br></di=
v><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;borde=
r-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
&gt; c. Is it mandatory to have reviewer on Transifex? I saw not many langu=
ages doing reviews on the translation there.<br>
<br>
That&#39;s not mandatory, yet if you want a good quality I think reviewing =
is a good step. In France we don&#39;t use Transfiex because we&#39;re usin=
g github pull requests to proofread a lot, and a lot of mistakes are catche=
d at this step [2].<br>
<br></blockquote><div>hm, it&#39;s very good example. will gather more peop=
le to work on it.</div><div>=C2=A0</div><blockquote class=3D"gmail_quote" s=
tyle=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);pad=
ding-left:1ex">
&gt; d. and what to do next, if I have completed the translations (a), to b=
e included on language switcher?<br>
<br>
Once the repository migrated, open a PR to add your language here: <a href=
=3D"https://github.com/python/docsbuild-scripts/blob/master/build_docs.py#L=
62" rel=3D"noreferrer" target=3D"_blank">https://github.com/python/docsbuil=
d-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=3D"ht=
tp://docs.python.org" rel=3D"noreferrer" target=3D"_blank">docs.python.org<=
/a> so you can check if everything&#39;s OK before opening to the public.<b=
r>
<br>
If everything renders correctly you&#39;ll have to open another pull reques=
t to add your language to the switcher here: <a href=3D"https://github.com/=
python/cpython/blob/master/Doc/tools/static/switchers.js#L21" rel=3D"norefe=
rrer" target=3D"_blank">https://github.com/python/cpython/blob/master/Doc/t=
ools/static/switchers.js#L21</a><br>
<br></blockquote><div>I will do this part later, I think I need to test bui=
ld with &#39;docsbuild-scripts&#39; first at a local machine.</div><div><br=
></div><div>--=C2=A0</div><div>sincerely,</div><div>oon arfiandwi</div><div=
><br></div><div>=C2=A0</div></div></div>

--000000000000c7f7e70594eec034--

--===============8477006117821363690==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

_______________________________________________
Doc-SIG maillist  -  [email protected]
https://mail.python.org/mailman/listinfo/doc-sig

--===============8477006117821363690==--