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/
