table of contents to support groups?

[gre]

with configuration.yml, you can do things like this:

toc:
  - Map
  - LngLat
  - LngLatBounds

I think it would actually be great if you could level it at multiple levels, meaning it would be "groups" in the HTML:

toc:
  - libraryPartOne
    - Map
  - libraryPartTwo
    - LngLat
    - LngLatBounds

( a bit like in gitbooks actually: https://paulkogel.gitbooks.io/redux-docs/content/ )

[tmcw]

Yep, this would definitely be great, and we're very open to PRs that would implement this. The current table of contents implementation is a very minimal, restrictive version, aimed more at making sure we don't break other kind of hierarchy rather than making hierarchy especially expressive. If anyone wants to take a second look at the code and improve it, please do! The relevant code for integrating the toc is in sort.js.