python-docs-theme icon indicating copy to clipboard operation
python-docs-theme copied to clipboard

Implement collapsable navigation menus like Wikipedia on moblie

Open bordenc opened this issue 5 months ago • 3 comments

The Python documentation table of contents is massive. It's unwieldy on a mobile device. A lot of that comes from itemising all the changelogs going back to 3.0 release. In and of itself, that's fine, but it takes a lot of scrolling to find anything. The indentation also isn't terribly clear to identify what is a subheading of what. Highly nested headings exacerbates this.

Collapsable TOC headings, used on sites like Wikipedia, would help tremendously with this. That way, mobile users could see a cleaner layout resembling the desktop TOC display, then be able to drill down into whatever topic they're looking for.

bordenc avatar Jul 05 '25 05:07 bordenc

Please can you give links and screenshots of both the specific Python table of contents and also an example Wikipedia page?

hugovk avatar Jul 05 '25 21:07 hugovk

Here's how the TOC looks on my device (Firefox on Android)

Image Image Image

And here's how a couple Wikipedia pages look on my device (with an expanded section to show the effect)

Image Image

To be specific, although Wikipedia has collapsable sections, what I'm hoping for is collapsable menus, where subheadings can roll up into the heading. And another example I found on the web.

bordenc avatar Jul 05 '25 23:07 bordenc

Links:

  • https://docs.python.org/3/contents.html
  • https://en.m.wikipedia.org/wiki/GitHub

hugovk avatar Jul 06 '25 06:07 hugovk