[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
Would be good to see @Lorena and @JulienPalard from the translation WG, might be helpful Kind Regards, Abdur-Rahmaan Janhangeer https://www.github.com/Abdur-RahmaanJ Mauritius sent from gmail client on Android, that's why the signature is so ugly. ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/GBEBD6YBN6AV52DLTXFBCG5WQDDATLRA/ Code of Conduct: http://python.org/psf/codeofconduct/
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
Hey Team, Has this workgroup started yet? If not, can I help get it going, or if so, is there a mailing list or place where things are happening? Brian Curtin On Sun, Aug 9, 2020 at 12:58 Carol Willing wrote: > Hi folks, > > Thanks for the interest. I apologize for the delay in getting this > workgroup started. I'm happy that there is strong interest in working on > documentation and improving it for all users. > > I will do my best to get the workgroup charter drafted this week and then > open an interest list for initial workgroup members. > > Luciano, I agree that rewriting asyncio docs and typing are helpful > improvements and welcome your contributions to accessible and high quality > docs. > > Warmly, > > Carol > > On Sun, Aug 9, 2020 at 9:21 AM Luciano Ramalho > wrote: > >> I am also interested in helping with making Python's documentation >> more user friendly. >> >> Yuri Selivanov's rewrite of the asyncio documentation was brilliant. >> We need more of that. >> >> My recent contribution to Python's doc doesn't compare with >> Selivanov's awesome rewrite, but it involved reorganizing existing >> documentation. >> >> The typing module chapter in the library reference is comprehensive, >> and the top 1/3 of it has good narrative explanations to the core >> concepts. But the remaining 2/3 of the content is in a single section >> titled "Classes, functions, and decorators" that covers more than 70 >> objects, and there's no apparent ordering. >> >> With the help of Guido, I split that section in subsections, and >> arranged the entries within the subsections by relevance to most >> users—subjective, yes, but not too harmful if we made bad calls, >> because now there are fewer entries per subsection. >> >> Before: >> https://docs.python.org/3.8/library/typing.html >> >> After: >> https://docs.python.org/3.10/library/typing.html >> >> Cheers, >> >> Luciano >> >> On Sun, Aug 9, 2020 at 12:43 PM Mats Wichmann wrote: >> > >> > On 8/5/20 10:43 AM, Dominic Davis-Foster wrote: >> > > Hi Carol, >> > > >> > > I was wondering if you've been able to set up the workgroup yet? I'd >> certainly be interested in participating the there's an opportunity. >> > > >> > > >> > > Stay safe >> > > >> > > Dom >> > >> > Indeed, I was wondering if there were any updates - I'm also interested >> > in participating. >> > >> > -- mats >> > ___ >> > Python-Dev mailing list -- python-dev@python.org >> > To unsubscribe send an email to python-dev-le...@python.org >> > https://mail.python.org/mailman3/lists/python-dev.python.org/ >> > Message archived at >> https://mail.python.org/archives/list/python-dev@python.org/message/MRV5SQCC2GC6MLIUCSPJZL3AQCXVDUEG/ >> > Code of Conduct: http://python.org/psf/codeofconduct/ >> >> >> >> -- >> Luciano Ramalho >> | Author of Fluent Python (O'Reilly, 2015) >> | http://shop.oreilly.com/product/0636920032519.do >> | Technical Principal at ThoughtWorks >> | Twitter: @ramalhoorg >> ___ >> Python-Dev mailing list -- python-dev@python.org >> To unsubscribe send an email to python-dev-le...@python.org >> https://mail.python.org/mailman3/lists/python-dev.python.org/ >> Message archived at >> https://mail.python.org/archives/list/python-dev@python.org/message/P6S4Q3H6VOXVJTXX4UCRRYDCIDLC2M4C/ >> Code of Conduct: http://python.org/psf/codeofconduct/ >> > ___ > Python-Dev mailing list -- python-dev@python.org > To unsubscribe send an email to python-dev-le...@python.org > https://mail.python.org/mailman3/lists/python-dev.python.org/ > Message archived at > https://mail.python.org/archives/list/python-dev@python.org/message/ZTIK4R7HNPV2HZJ6TJHONGCCYUOSL5CW/ > Code of Conduct: http://python.org/psf/codeofconduct/ > ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/MCGGPWD5C66IG3ITL2SOROYW62CQTKBJ/ Code of Conduct: http://python.org/psf/codeofconduct/
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
Add my name. From: python-dev-requ...@python.org Sent: Sunday, August 9, 2020 11:00 AM To: python-dev@python.org Subject: Python-Dev Digest, Vol 205, Issue 17 Send Python-Dev mailing list submissions to python-dev@python.org To subscribe or unsubscribe via the World Wide Web, visit https://mail.python.org/mailman3/lists/python-dev.python.org/ or, via email, send a message with subject or body 'help' to python-dev-requ...@python.org You can reach the person managing the list at python-dev-ow...@python.org When replying, please edit your Subject line so it is more specific than "Re: Contents of Python-Dev digest..." Today's Topics: 1. Re: Python Documentation, Python language improvement, and productive discussion (Mats Wichmann) -- Date: Sun, 9 Aug 2020 09:39:32 -0600 From: Mats Wichmann Subject: [Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion To: python-dev@python.org Message-ID: <421995fd-99ae-99a5-0262-33d243c93...@python.org> Content-Type: text/plain; charset=utf-8 On 8/5/20 10:43 AM, Dominic Davis-Foster wrote: > Hi Carol, > > I was wondering if you've been able to set up the workgroup yet? I'd > certainly be interested in participating the there's an opportunity. > > > Stay safe > > Dom Indeed, I was wondering if there were any updates - I'm also interested in participating. -- mats -- Subject: Digest Footer ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ -- End of Python-Dev Digest, Vol 205, Issue 17 *** ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/LB4UEY5BQB4PDLOTSVYLCCAOFL6ZBYS5/ Code of Conduct: http://python.org/psf/codeofconduct/
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
Hi folks, Thanks for the interest. I apologize for the delay in getting this workgroup started. I'm happy that there is strong interest in working on documentation and improving it for all users. I will do my best to get the workgroup charter drafted this week and then open an interest list for initial workgroup members. Luciano, I agree that rewriting asyncio docs and typing are helpful improvements and welcome your contributions to accessible and high quality docs. Warmly, Carol On Sun, Aug 9, 2020 at 9:21 AM Luciano Ramalho wrote: > I am also interested in helping with making Python's documentation > more user friendly. > > Yuri Selivanov's rewrite of the asyncio documentation was brilliant. > We need more of that. > > My recent contribution to Python's doc doesn't compare with > Selivanov's awesome rewrite, but it involved reorganizing existing > documentation. > > The typing module chapter in the library reference is comprehensive, > and the top 1/3 of it has good narrative explanations to the core > concepts. But the remaining 2/3 of the content is in a single section > titled "Classes, functions, and decorators" that covers more than 70 > objects, and there's no apparent ordering. > > With the help of Guido, I split that section in subsections, and > arranged the entries within the subsections by relevance to most > users—subjective, yes, but not too harmful if we made bad calls, > because now there are fewer entries per subsection. > > Before: > https://docs.python.org/3.8/library/typing.html > > After: > https://docs.python.org/3.10/library/typing.html > > Cheers, > > Luciano > > On Sun, Aug 9, 2020 at 12:43 PM Mats Wichmann wrote: > > > > On 8/5/20 10:43 AM, Dominic Davis-Foster wrote: > > > Hi Carol, > > > > > > I was wondering if you've been able to set up the workgroup yet? I'd > certainly be interested in participating the there's an opportunity. > > > > > > > > > Stay safe > > > > > > Dom > > > > Indeed, I was wondering if there were any updates - I'm also interested > > in participating. > > > > -- mats > > ___ > > Python-Dev mailing list -- python-dev@python.org > > To unsubscribe send an email to python-dev-le...@python.org > > https://mail.python.org/mailman3/lists/python-dev.python.org/ > > Message archived at > https://mail.python.org/archives/list/python-dev@python.org/message/MRV5SQCC2GC6MLIUCSPJZL3AQCXVDUEG/ > > Code of Conduct: http://python.org/psf/codeofconduct/ > > > > -- > Luciano Ramalho > | Author of Fluent Python (O'Reilly, 2015) > | http://shop.oreilly.com/product/0636920032519.do > | Technical Principal at ThoughtWorks > | Twitter: @ramalhoorg > ___ > Python-Dev mailing list -- python-dev@python.org > To unsubscribe send an email to python-dev-le...@python.org > https://mail.python.org/mailman3/lists/python-dev.python.org/ > Message archived at > https://mail.python.org/archives/list/python-dev@python.org/message/P6S4Q3H6VOXVJTXX4UCRRYDCIDLC2M4C/ > Code of Conduct: http://python.org/psf/codeofconduct/ > ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/ZTIK4R7HNPV2HZJ6TJHONGCCYUOSL5CW/ Code of Conduct: http://python.org/psf/codeofconduct/
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
I am also interested in helping with making Python's documentation more user friendly. Yuri Selivanov's rewrite of the asyncio documentation was brilliant. We need more of that. My recent contribution to Python's doc doesn't compare with Selivanov's awesome rewrite, but it involved reorganizing existing documentation. The typing module chapter in the library reference is comprehensive, and the top 1/3 of it has good narrative explanations to the core concepts. But the remaining 2/3 of the content is in a single section titled "Classes, functions, and decorators" that covers more than 70 objects, and there's no apparent ordering. With the help of Guido, I split that section in subsections, and arranged the entries within the subsections by relevance to most users—subjective, yes, but not too harmful if we made bad calls, because now there are fewer entries per subsection. Before: https://docs.python.org/3.8/library/typing.html After: https://docs.python.org/3.10/library/typing.html Cheers, Luciano On Sun, Aug 9, 2020 at 12:43 PM Mats Wichmann wrote: > > On 8/5/20 10:43 AM, Dominic Davis-Foster wrote: > > Hi Carol, > > > > I was wondering if you've been able to set up the workgroup yet? I'd > > certainly be interested in participating the there's an opportunity. > > > > > > Stay safe > > > > Dom > > Indeed, I was wondering if there were any updates - I'm also interested > in participating. > > -- mats > ___ > Python-Dev mailing list -- python-dev@python.org > To unsubscribe send an email to python-dev-le...@python.org > https://mail.python.org/mailman3/lists/python-dev.python.org/ > Message archived at > https://mail.python.org/archives/list/python-dev@python.org/message/MRV5SQCC2GC6MLIUCSPJZL3AQCXVDUEG/ > Code of Conduct: http://python.org/psf/codeofconduct/ -- Luciano Ramalho | Author of Fluent Python (O'Reilly, 2015) | http://shop.oreilly.com/product/0636920032519.do | Technical Principal at ThoughtWorks | Twitter: @ramalhoorg ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/P6S4Q3H6VOXVJTXX4UCRRYDCIDLC2M4C/ Code of Conduct: http://python.org/psf/codeofconduct/
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
On 8/5/20 10:43 AM, Dominic Davis-Foster wrote: > Hi Carol, > > I was wondering if you've been able to set up the workgroup yet? I'd > certainly be interested in participating the there's an opportunity. > > > Stay safe > > Dom Indeed, I was wondering if there were any updates - I'm also interested in participating. -- mats ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/MRV5SQCC2GC6MLIUCSPJZL3AQCXVDUEG/ Code of Conduct: http://python.org/psf/codeofconduct/
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
Hi Carol, I was wondering if you've been able to set up the workgroup yet? I'd certainly be interested in participating the there's an opportunity. Stay safe Dom ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/OBA7L7C7IMG2MK5RMBPJLMBZHYIMJA57/ Code of Conduct: http://python.org/psf/codeofconduct/
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion (Antoine Pitrou)
I'm interested in being part of said Docs group! David From: python-dev-requ...@python.org Sent: Thursday, July 2, 2020 5:33 PM To: python-dev@python.org Subject: Python-Dev Digest, Vol 204, Issue 23 Send Python-Dev mailing list submissions to python-dev@python.org To subscribe or unsubscribe via the World Wide Web, visit https://mail.python.org/mailman3/lists/python-dev.python.org/ or, via email, send a message with subject or body 'help' to python-dev-requ...@python.org You can reach the person managing the list at python-dev-ow...@python.org When replying, please edit your Subject line so it is more specific than "Re: Contents of Python-Dev digest..." Today's Topics: 1. Re: Python Documentation, Python language improvement, and productive discussion (Antoine Pitrou) 2. Re: Recent PEP-8 change (Antoine Pitrou) 3. Re: Re Re: Recent PEP-8 change (Ivan Pozdeev) (Ivan Pozdeev) -- Date: Fri, 3 Jul 2020 00:10:04 +0200 From: Antoine Pitrou Subject: [Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion To: python-dev@python.org Message-ID: <20200703001004.0fca6c23@fsol> Content-Type: text/plain; charset=US-ASCII On Thu, 02 Jul 2020 20:41:54 - "Carol Willing" wrote: > > Earlier this year at the Python Language Summit, Ned Batchelder and I > presented the concept of a Documentation Workgroup and a vision for the next > few years: > > - Slidedeck > https://speakerdeck.com/willingc/cpython-documentation-the-next-5-years > - Blog post > https://pyfound.blogspot.com/2020/04/cpython-documentation-next-5-years.html > > Due to some health issues that I have had the past few months, I haven't yet > set up the workgroup. It's a priority of mine for July. We will have an open > call for workgroup participants. Kudos for doing this. Having a consistent editorial direction for the documentation is a great idea. Regards Antoine. -- Date: Fri, 3 Jul 2020 00:15:29 +0200 From: Antoine Pitrou Subject: [Python-Dev] Re: Recent PEP-8 change To: python-dev@python.org Message-ID: <20200703001529.2c9ff416@fsol> Content-Type: text/plain; charset=US-ASCII On Thu, 02 Jul 2020 17:58:44 -0400 Random832 wrote: > On Thu, Jul 2, 2020, at 05:20, Antoine Pitrou wrote: > > We're not talking about posting "your own writing", we're talking about > > comments (and presumably documentation) in a collective software > > project. There's a need for consistency, however it's > > specified and achieved. > > > > Otherwise why stop at English? I could just as well write my comments > > in French if it's all about individual freedom. Requiring English is > > not inclusive, it forced people like me to painfully adapt to a > > language I wasn't used to. And that has nothing to do with "white > > supremacy". > > Why indeed? Because we're talking about PEP 8, and PEP 8 intends to cover the code style used when writing code in the *Python standard library*. I don't think other Python core developers would like to read code with comments written in French (or, indeed, in Russian or Japanese or...). We're not talking about third-party projects, which indeed choose whatever style and language suit them. Regards Antoine. -- Date: Fri, 3 Jul 2020 01:32:38 +0300 From: Ivan Pozdeev Subject: [Python-Dev] Re: Re Re: Recent PEP-8 change (Ivan Pozdeev) To: python-dev@python.org Message-ID: Content-Type: multipart/alternative; boundary="0905C79342DDD68A7F40BFCF" This is a multi-part message in MIME format. --0905C79342DDD68A7F40BFCF Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: quoted-printable At https://git-scm.com/book/en/v2/Git-Branching-Rebasing#_rebase_vs_merge= , they say that the argument of whether to allow overwriting=20 history in VCSes stems from two opposing views on what a project's histor= y should be. One is that is shall be a raw, unedited record of=20 events as they happened; the other is that is should be a (polished and a= dapted for future reading) story of how the project was made. While I'm firmly in camp story (long story short, it makes history much m= ore useful for everything except playing the blame game), in this=20 case, there's a case-specific reason, too. The remarks that stem the controversy have nothing to do with commit's in= tent in technical terms: clarifying wording that cause=20 misunderstanding. They were simply speculations by the author (and misgui= ded ones at that since Strunk & White are actually names). Leaving this commit as it is will leave no trace of any "comm
[Python-Dev] Re: Python Documentation, Python language improvement, and productive discussion
On Thu, 02 Jul 2020 20:41:54 - "Carol Willing" wrote: > > Earlier this year at the Python Language Summit, Ned Batchelder and I > presented the concept of a Documentation Workgroup and a vision for the next > few years: > > - Slidedeck > https://speakerdeck.com/willingc/cpython-documentation-the-next-5-years > - Blog post > https://pyfound.blogspot.com/2020/04/cpython-documentation-next-5-years.html > > Due to some health issues that I have had the past few months, I haven't yet > set up the workgroup. It's a priority of mine for July. We will have an open > call for workgroup participants. Kudos for doing this. Having a consistent editorial direction for the documentation is a great idea. Regards Antoine. ___ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/36OTCMDX3LILTGWEIQY2KSGML3VZZSDC/ Code of Conduct: http://python.org/psf/codeofconduct/
