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 <willi...@gmail.com> 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 <luci...@ramalho.org> > 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 <m...@python.org> 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/
