@jvns @dscho This is a first try at integrating the TOC better. I'm not yet fully in love with it, but wanted to share my first idea already.

I wonder whether it is even possible to keep the table of contents sticky without it being in the

section...

@dscho Yeah, that's something I wanted to figure out still.

@dscho This is still work-in-progress to see if we like the design. Once we settle on the look, I will figure out how to make it all work.

@dscho This is still work-in-progress to see if we like the design. Once we settle on the look, I will figure out how to make it all work.

For example, would "on this page" on the top work better?

I like that! @jvns what is your opinion?

I like the way it connects to the page's content! It feels a little weird to push the main navigation down like that -- in a way it seems like the "table of contents" should actually be a sub-item of "Reference" somehow (like we're at Documentation -> Reference -> git-add. But I don't see a way to put it there.

@jvns I kind a like that idea. I've been wanted to have more like a breadcrumbs style navigation and that's what you're suggesting with Documentation -> Reference -> git-add. Now putting that in the sidebar, and then the headings of that page in that tree will nest them very deep and indentation will make it impossible to have headings that are longer than a few chars. So far from ideal.

Personally I think the whole navigation on this website is awkward. Maybe a bigger overhaul is needed. If we can find someone to put the work into that (not sure that one will be me, but I'll think about it). cc @dscho