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/