toc_depth change to 3 by default and 2 as an exception

[LinusSch]

We currently have

markdown_extensions:
  - toc:
      toc_depth: 2

site-wide in our mkdocs.yml. This is not a very sensible default, as it creates a single-level ToC for navigating the page. Two levels, as created by toc_depth: 3 make a lot more sense for almost all well-organized pages.

However, we have several pages where the latter creates a problematically long ToC. Therefore, I intend to enable per-page overrides for this setting.

I have not figured out a way to find all pages which will need this override, any ideas will be appreciated.

[richelbilderbeek]

Thanks for this fun suggestion!

I am neutral to this. If anyone thinks that this improves a page, I encourage him/her to do it 👍

[bclaremar]

Voting YES