I want a second layer of "grouping" in the navigation.

[mirisuzanne]

The sidebar can get quite long, quickly – and often there are logical page-groups such as "configuration", "design tokens", "patterns", 'components", "layouts", etc. I propose handling this in the Herman config, where we already allow group-sorting & naming.

[jgerigmeyer]

Currently, we just use the standard SassDoc groups option (http://sassdoc.com/configuration/#groups); there is no Herman-specific config here.

How do you propose subgroups would be defined in the config?

[mirisuzanne]

I was imagining nested lists:

groups:
  - Configuration:
    - config-colors: _Colors
    - config-fonts: _Fonts
  - Patterns:
    - pattern-buttons: _Buttons
    - pattern-inputs: _Inputs

[jgerigmeyer]

So you can nest indefinitely, and we determine based on whether the value is a string or array?

I’ll have to look into how the SassDoc groups option works. Sounds like we’d be replacing it with this. I’d hate to require duplication of user settings, but I also don’t want to duplicate a lot of internal SassDoc logic.

[mirisuzanne]

I was not imagining indefinite nesting - just adding a single layer. I agree that we should avoid duplicating this.

[jgerigmeyer]

PR: #233.