Restructuring the stdlib docs

[adorilson (Adorilson Bezerra)]

@petersuter

@hugovk

Some earlier discussions:

Also:

And some more:

Diátaxis and Python documentation

I’d like to put forward a vision for the future of Python’s documentation, as published at https://docs.python.org, in the hope of building general consensus for two things: an idea of what good means in documentation and its application to Python’s documentation in particular ways of working that will bring about significant improvements more swiftly I see a very strong opportunity to bring what I can do, to what I think Python’s documentation needs, and I would like to do more of that work …

Some more recent discussion on this topic starts here (with suggestions and some identified problems): Diátaxis and Python documentation - #9 by adorilson

Considerations on the turtle docs: Improving the Turtle library - #10 by adorilson

Here we’ve discussed listing modules in alphabetical order.

Last days, I’ve analyzed the library/index page. So, besides the alphabetical order, I have two more suggestions:

1. Moving the module categories to a new page, replacing all of them in library/index by a meta-category, maybe “Standard library modules“
2. Reviewing every category. For instance, we can rearrange the Tk’s stuff, something like:

   • Graphical user interfaces

     • turtle — Turtle graphics

     • IDLE

     • Graphical User Interfaces with Tk

     Here, the modules are listed on top. After them comes everything that isn’t a module itself. Also, I ask myself if IDLE shouldn’t be in the Development Tools category.