[Feature] Improve table of contents to be more consistent with other documentation sites. about docs

[TheRolfFR]

I would not recommend putting the table of content inside the navbar as it is already pretty crowded.
Also I think separating both would make more sense.
In you discord.py documentation example, the layout is different as we have much more pages and a navigation drawer.
Electron documentation is much closer to what we have (https://www.electronjs.org/docs/latest/tutorial/installation) and it doesn't affect the read quality.

[3vorp]

I suppose? but I feel like Faithful applies more to the discord.py example since we have much more complicated articles with a lot of nested headings, plus the sidebar is used a lot more effectively here than on the faithful docs site where you pretty much only use it to switch to completely unrelated articles rather than here where it seems like you're going through a tutorial on how to use the program and would keep going down the list on the left

[TheRolfFR]

Okay, you're right. Would you like to load all tables of contents in nav or just the currently loaded page? All tables of content may be difficult

[3vorp]

every article having a visible dropdown at once would be nice if that's not too difficult, but I understand your concerns and would be fine with having just the currently loaded page have the table of contents opened

[3vorp]

just found the linux kernel docs have pretty much exactly the same setup that I'm asking for, including category titles etc

https://www.kernel.org/doc/html/v4.10/process/development-process.html

it only shows top-level headings on the sidebar which I quite like — we could just grab all h1 elements and display those titles on the left bar

also, I really like how the table of contents is both present at the start of the article and on the sidebar — if you want each subpoint carefully listed out you can go to the top of the article but you can go to the main talking points anywhere in the article

[3vorp]

completed with #24