[Feature Request] Create Class, Interface and Enums as expanders in the TOC for .NET Documentation

[UmaHarano]

The TOC for my .NET assembly namespace types lists "Classes" "Interface" and "Enums" as "Toc Titles". Is there a way to make them into expanders in the TOC instead? This will make the TOC more compact. I have many types in a namespace and it would nice to collapse them.

I want this behavior instead:

Additional information:
#9933 (comment)

[filzrev]

The proposed implementation is as follows.

• Add categoryLayout option to metadata section.
• If "categoryLayout": "nested" option is enabled.
  Reorganize TOC structure as described at Create Class, Interface and Enums as expanders in the TOC for .NET Documentation #9933 (comment).

If there seems to be no particular problems. I'll create PR later.

Config document to be added

---

categoryLayout

Specifies how categories in TOC are organized:

• flattened (default): Renders namespaces as a plain label.
• nested: Renders category in a nested tree form.

Note

This setting is is available when using ApiPage or Markdown output format. mref format don't support categories.

[yufeih]

We could incorporate this change if there is sufficient interest. Please upvote if you find this useful.

[UmaHarano]

What is the best way to Upvote? In this issue or in the original discussion thread?

[UmaHarano]

Also, I want to also add that -
when I use outputFormat = apiPage, my custom template is not being used. I lose the ability to customize the site with my template (partial files, main.js, etc).
If there is a workaround for this, please let me know.

[UmaHarano]

Will this fix be in the next release of DocFX? When will this be? Thank you!