From matt at whoosh.ca  Mon Jan  4 09:48:45 2021
From: matt at whoosh.ca (Matt Chaput)
Date: Mon, 04 Jan 2021 14:48:45 GMT
Subject: [Doc-SIG] PEP 257
In-Reply-To: <000001d6de4f$3f3292f0$bd97b8d0$@dexmicro.com>
References: <000001d6de4f$3f3292f0$bd97b8d0$@dexmicro.com>
Message-ID: <FFD05516-5FC3-405F-9884-EABFCFAB9AAA@whoosh.ca>

I don't see a contradiction? The note says to use "return" instead of "returns", and the docstring example uses "return".

> On Dec 29, 2020, at 8:58 PM, Paul Graves-DesLauriers <paul at dexmicro.com> wrote:
> 
> I would like clarification about the one-line docstring example.
>  
> The Notes say (fourth bullet):
> The docstring is a phrase ending in a period. It prescribes the function or method's effect as a command ("Do this", "Return that"), not as a description; e.g. don't write "Returns the pathname ...".
>  
> However the docstring example for kos_root() is:  ???Return the pathname of the KOS root directory.???
>  
> I?ve highlighted the areas that seem to contradict each other.  Perhaps the example should be updated to conform to the notes?


From cocoatomo77 at gmail.com  Thu Jan 21 21:07:00 2021
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Fri, 22 Jan 2021 11:07:00 +0900
Subject: [Doc-SIG] File 0 on Transifex
In-Reply-To: <CACUNLpVv79bikVip_8VjXfgKPwcxx6K1WHD0-ZiXjByKZM_q0A@mail.gmail.com>
References: <CACUNLpUfHxeKiFe=b9TtLRMkBfJKy-R7fTuvxg7++uO-Y_OO8Q@mail.gmail.com>
 <CACUNLpW2KiqkwNmroh5qoMqms5cfr8GgiaSJ7UZWfku6PV=Csg@mail.gmail.com>
 <5t-Pnc7HQKJEa0-fxRmDMSC6jKIDP4Wt_5Gb7nfCDgnB5no28f91oOftMJy9dKKd_7vchIC7OPQs2VBkqhNuviu976S2ffV4nS3SJRY99d0=@palard.fr>
 <CACUNLpVv79bikVip_8VjXfgKPwcxx6K1WHD0-ZiXjByKZM_q0A@mail.gmail.com>
Message-ID: <CAN_7T0+LDpDaRfXSVRbPPNJ5OTAk=6t8fb8Zib_0_mZEwCycLw@mail.gmail.com>

Dear Doc SIG members, oon and Julien,
sorry for the very late response.

As Julien mentioned, files named "0" (0.pot, 0.po, etc) were created
due to the change of the Sphinx command option "-D gettext_compact=0"
behavior.
This bug was resolved last month by the Sphinx maintainer tk0miya! Very
thanks!

So I deleted all files named "0" in transifex projects (Python, Python 2.7,
Python 3.8)
and related GitHub repositories.

Best regards,
cocoatomo

On Thu, 24 Dec 2020 at 19:04, oon arfiandwi <oon.arfiandwi at gmail.com> wrote:

>
>
> On Thu, Dec 24, 2020 at 5:59 PM Julien Palard <julien at palard.fr> wrote:
>
>> > I just want to update my email below. The problem got fixed.
>> > (still don't know why and how)
>> > I just got a "normal" email from Transfex that describes which files
>> got updated.
>> > Previously it's only reported that file 0 got updated.
>>
>> It looks related to https://github.com/sphinx-doc/sphinx/issues/8549
>>
>>
>>
> Hi Julien, thank you for the reference.
> happy holiday!
>
> --
> sincerely,
> oon arfiandwi
>
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> https://mail.python.org/mailman/listinfo/doc-sig
>


-- 
class Cocoatomo:
    name = 'cocoatomo'
    email_address = 'cocoatomo77 at gmail.com'
    twitter_id = '@cocoatomo'
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.python.org/pipermail/doc-sig/attachments/20210122/0575a077/attachment.html>

From oon.arfiandwi at gmail.com  Thu Jan 21 23:57:42 2021
From: oon.arfiandwi at gmail.com (oon arfiandwi)
Date: Fri, 22 Jan 2021 12:57:42 +0800
Subject: [Doc-SIG] File 0 on Transifex
In-Reply-To: <CAN_7T0+LDpDaRfXSVRbPPNJ5OTAk=6t8fb8Zib_0_mZEwCycLw@mail.gmail.com>
References: <CACUNLpUfHxeKiFe=b9TtLRMkBfJKy-R7fTuvxg7++uO-Y_OO8Q@mail.gmail.com>
 <CACUNLpW2KiqkwNmroh5qoMqms5cfr8GgiaSJ7UZWfku6PV=Csg@mail.gmail.com>
 <5t-Pnc7HQKJEa0-fxRmDMSC6jKIDP4Wt_5Gb7nfCDgnB5no28f91oOftMJy9dKKd_7vchIC7OPQs2VBkqhNuviu976S2ffV4nS3SJRY99d0=@palard.fr>
 <CACUNLpVv79bikVip_8VjXfgKPwcxx6K1WHD0-ZiXjByKZM_q0A@mail.gmail.com>
 <CAN_7T0+LDpDaRfXSVRbPPNJ5OTAk=6t8fb8Zib_0_mZEwCycLw@mail.gmail.com>
Message-ID: <CACUNLpVfGZYtUDPXGR9nphmf40_7nEHdhSSQyOaTSS0j+ifuiA@mail.gmail.com>

Dear cocoatomo,
thank you for the updates.

As I mentioned before, the projects at Transifex are working well.
It just sometimes I saw the translation memories are from file 0, but it's
ok.

-- 
sincerely,
oon arfiandwi


On Fri, Jan 22, 2021 at 10:07 AM tomo cocoa <cocoatomo77 at gmail.com> wrote:

> Dear Doc SIG members, oon and Julien,
> sorry for the very late response.
>
> As Julien mentioned, files named "0" (0.pot, 0.po, etc) were created
> due to the change of the Sphinx command option "-D gettext_compact=0"
> behavior.
> This bug was resolved last month by the Sphinx maintainer tk0miya! Very
> thanks!
>
> So I deleted all files named "0" in transifex projects (Python, Python
> 2.7, Python 3.8)
> and related GitHub repositories.
>
> Best regards,
> cocoatomo
>
> On Thu, 24 Dec 2020 at 19:04, oon arfiandwi <oon.arfiandwi at gmail.com>
> wrote:
>
>>
>>
>> On Thu, Dec 24, 2020 at 5:59 PM Julien Palard <julien at palard.fr> wrote:
>>
>>> > I just want to update my email below. The problem got fixed.
>>> > (still don't know why and how)
>>> > I just got a "normal" email from Transfex that describes which files
>>> got updated.
>>> > Previously it's only reported that file 0 got updated.
>>>
>>> It looks related to https://github.com/sphinx-doc/sphinx/issues/8549
>>>
>>>
>>>
>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.python.org/pipermail/doc-sig/attachments/20210122/1c2e5b08/attachment.html>

From julien at palard.fr  Mon Jan 25 04:24:29 2021
From: julien at palard.fr (Julien Palard)
Date: Mon, 25 Jan 2021 09:24:29 +0000
Subject: [Doc-SIG] Russian Docs Translation
In-Reply-To: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>
References: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>
Message-ID: <2cf77a61-6617-db07-2380-8bfbe81d21c3@palard.fr>

Hi!

Le 2021-01-25 ? 08:25, Kristina Mironova a ?crit?:
> Maksim joined us with full Python 3.8.3 documentation translated.
> You can see translation on his site 
> https://digitology.tech/docs/python_3/ 
> <https://digitology.tech/docs/python_3/>

Nice!

> Can you please create python/python-docs-ru?

If you already have a repo with content, the best way is to transfer it 
to the python org, but this can only be done by someone having the right 
to create a repo on the Python org so typically people first transfer 
the repo to me, then I transfer it to the Python org, but we did not 
tried to give me admin rights on the repo so I can try to transfer it 
directly, it may work too.

If you don't have a repo yet I can create an empty one and set you admin 
on it.

Bests,
-- 
[Julien Palard](https://mdk.fr)


From arj.python at gmail.com  Mon Jan 25 04:26:59 2021
From: arj.python at gmail.com (Abdur-Rahmaan Janhangeer)
Date: Mon, 25 Jan 2021 13:26:59 +0400
Subject: [Doc-SIG] Russian Docs Translation
In-Reply-To: <2cf77a61-6617-db07-2380-8bfbe81d21c3@palard.fr>
References: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>
 <2cf77a61-6617-db07-2380-8bfbe81d21c3@palard.fr>
Message-ID: <CADrxXXmB8Js2k+9dGKbCWBhkDOVuhNo=1NoSfhJj645+TUV01Q@mail.gmail.com>

Greetings list,

This calls for celebrations somehow as
events like these are turning points of
the WG

Kind Regards,

Abdur-Rahmaan Janhangeer
about <https://compileralchemy.github.io/> | blog
<https://www.pythonkitchen.com>
github <https://github.com/Abdur-RahmaanJ>
Mauritius


On Mon, Jan 25, 2021 at 1:24 PM Julien Palard via Doc-SIG <
doc-sig at python.org> wrote:

> Hi!
>
> Le 2021-01-25 ? 08:25, Kristina Mironova a ?crit :
> > Maksim joined us with full Python 3.8.3 documentation translated.
> > You can see translation on his site
> > https://digitology.tech/docs/python_3/
> > <https://digitology.tech/docs/python_3/>
>
> Nice!
>
> > Can you please create python/python-docs-ru?
>
> If you already have a repo with content, the best way is to transfer it
> to the python org, but this can only be done by someone having the right
> to create a repo on the Python org so typically people first transfer
> the repo to me, then I transfer it to the Python org, but we did not
> tried to give me admin rights on the repo so I can try to transfer it
> directly, it may work too.
>
> If you don't have a repo yet I can create an empty one and set you admin
> on it.
>
> Bests,
> --
> [Julien Palard](https://mdk.fr)
>
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> https://mail.python.org/mailman/listinfo/doc-sig
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.python.org/pipermail/doc-sig/attachments/20210125/d856e860/attachment.html>

From abckristinaa at gmail.com  Mon Jan 25 02:25:27 2021
From: abckristinaa at gmail.com (Kristina Mironova)
Date: Mon, 25 Jan 2021 10:25:27 +0300
Subject: [Doc-SIG] Russian Docs Translation
Message-ID: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>

Hello Julien.

Maksim joined us with full Python 3.8.3 documentation translated.
You can see translation on his site https://digitology.tech/docs/python_3/

Can you please create python/python-docs-ru?

Best regards, Kristina Mironova
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.python.org/pipermail/doc-sig/attachments/20210125/47e75389/attachment.html>

From julien at palard.fr  Mon Jan 25 04:57:06 2021
From: julien at palard.fr (Julien Palard)
Date: Mon, 25 Jan 2021 09:57:06 +0000
Subject: [Doc-SIG] Russian Docs Translation
In-Reply-To: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>
References: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>
Message-ID: <0eae32bb-6976-f249-6641-c9701d324ce1@palard.fr>

Le 2021-01-25 ? 08:25, Kristina Mironova a ?crit?:
> Maksim joined us with full Python 3.8.3 documentation translated.

I just realised. When you wrote "full" you meant "full" (I'm slow ...).

Wow, wow, wow.

In france here we started 20 years ago and we only translated the half 
of it :D

How did you managed it?

-- 
[Julien Palard](https://mdk.fr)


From arj.python at gmail.com  Mon Jan 25 05:59:23 2021
From: arj.python at gmail.com (Abdur-Rahmaan Janhangeer)
Date: Mon, 25 Jan 2021 14:59:23 +0400
Subject: [Doc-SIG] Russian Docs Translation
In-Reply-To: <0eae32bb-6976-f249-6641-c9701d324ce1@palard.fr>
References: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>
 <0eae32bb-6976-f249-6641-c9701d324ce1@palard.fr>
Message-ID: <CADrxXXkX4mTkMr+50kBaXMZ+PJ+RmrtOL4MO9ZoD9onVypN2-g@mail.gmail.com>

Russian Botz At Work ^^

On Mon, 25 Jan 2021, 13:57 Julien Palard via Doc-SIG, <doc-sig at python.org>
wrote:

> Le 2021-01-25 ? 08:25, Kristina Mironova a ?crit :
> > Maksim joined us with full Python 3.8.3 documentation translated.
>
> I just realised. When you wrote "full" you meant "full" (I'm slow ...).
>
> Wow, wow, wow.
>
> In france here we started 20 years ago and we only translated the half
> of it :D
>
> How did you managed it?
>
> --
> [Julien Palard](https://mdk.fr)
>
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> https://mail.python.org/mailman/listinfo/doc-sig
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.python.org/pipermail/doc-sig/attachments/20210125/59d6a418/attachment-0001.html>

From cocoatomo77 at gmail.com  Mon Jan 25 06:53:25 2021
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Mon, 25 Jan 2021 20:53:25 +0900
Subject: [Doc-SIG] Russian Docs Translation
In-Reply-To: <CADrxXXkX4mTkMr+50kBaXMZ+PJ+RmrtOL4MO9ZoD9onVypN2-g@mail.gmail.com>
References: <CAFvA_dqzD=KmahosYSe4aRKS8ROrk+EPG1RE6kjnoCwo94GyMg@mail.gmail.com>
 <0eae32bb-6976-f249-6641-c9701d324ce1@palard.fr>
 <CADrxXXkX4mTkMr+50kBaXMZ+PJ+RmrtOL4MO9ZoD9onVypN2-g@mail.gmail.com>
Message-ID: <CAN_7T0Lzuj3iSFM0BvQnm-v3Bi1U5P9aMaeEJbeeZYdjdCp+Tw@mail.gmail.com>

Yay! Congratulations to all members of the Russian translator team!

Warmest regards,
cocoatomo

On Mon, 25 Jan 2021 at 19:59, Abdur-Rahmaan Janhangeer <arj.python at gmail.com>
wrote:

> Russian Botz At Work ^^
>
> On Mon, 25 Jan 2021, 13:57 Julien Palard via Doc-SIG, <doc-sig at python.org>
> wrote:
>
>> Le 2021-01-25 ? 08:25, Kristina Mironova a ?crit :
>> > Maksim joined us with full Python 3.8.3 documentation translated.
>>
>> I just realised. When you wrote "full" you meant "full" (I'm slow ...).
>>
>> Wow, wow, wow.
>>
>> In france here we started 20 years ago and we only translated the half
>> of it :D
>>
>> How did you managed it?
>>
>> --
>> [Julien Palard](https://mdk.fr)
>>
>> _______________________________________________
>> Doc-SIG maillist  -  Doc-SIG at python.org
>> https://mail.python.org/mailman/listinfo/doc-sig
>>
> _______________________________________________
> Doc-SIG maillist  -  Doc-SIG at python.org
> https://mail.python.org/mailman/listinfo/doc-sig
>


-- 
class Cocoatomo:
    name = 'cocoatomo'
    email_address = 'cocoatomo77 at gmail.com'
    twitter_id = '@cocoatomo'
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.python.org/pipermail/doc-sig/attachments/20210125/a1a187e9/attachment.html>