Definitely like the dark mode, since we're improving the docs anyway, how about these features/changes (maybe in another PR?):

• Make the list of classes in index.rst a dropdown one, so that the user is less overwhelmed at first look and it's easier to what's where. Perhaps this setting can help?

• Looks like we can also change where the 'edit on github' url points to (closing "Edit on GitHub" links in docs are misleading #2478). We can just link it to the corresponding file since most of our doc pages are from one file. Might have to do this for every file though.

• Styling the external links might look nice. Dunno how it looks like tho.

Nice ideas @harshil21 ! the external-links thingy was easy, pushing that directly to doc-fixes in a sec.

edit on github: IISC that would require either manually inserting :github_url: https://github.com/ptb/ptb/blos/master/telegram/… in each file or doing something hacky as proposed at readthedocs/sphinx_rtd_theme#465 (comment), see peterjc/thapbi-pict@f14b1df . IMO the first is tedious & the second error-prone (and will probably break at some point). As I personally don't see a great value, I won't try to get that to work - but also won't stand in the way of it :)

regarding the reference list: I've played around a bit, but didn't find a completey satisfactory solution. The best I could do was adding a :hidden: to the toctree:: directives in index.rst which hides doesn't render them on the start page but still includes them in the TOC in the navigation bar. Don't know if that's what we want …