New docs theme doesn't show subsections under (for example) pip install

[pfmoore]

As an example, compare https://pip.pypa.io/en/latest/reference/pip_install/ and https://pip.pypa.io/en/stable/reference/pip_install/

The sidebar for stable shows the subsections Usage, Description, Options and Examples, and Description is expandable another level. And there's a full multi-level table of contents at the top of the page. Both of these features are missing from the new layout, which is a significant regression in navigability.

[pradyunsg]

Which of these do we want to go with:

• increase the depth of headers in the sidebar
  • just a matter of bumping a number in conf.py
• add a table of contents on the reference pages
  • just the matter of putting a :contents: on top of the files

I like the first option. Either way, we should increase the depth of the tree in https://pip.pypa.io/en/latest/reference/ to be one step deeper -- like it is in stable.

Making a PR with first...

[pradyunsg]

Aside -- these changes were made in #4758.

[pfmoore]

Does the sidebar have click-to-expand behaviour like the old version, or is the full tree always visible?Personally, I like having both, but if we have to choose just one, I'd go with the sidebar.

Aside -- these changes were made in #4758.

Yeah, sorry I missed the implications then. I was distracted by the text-width thing, I guess :-(