Automatically generate TOC from folder structure

[tulsileathers]

DocFX Version Used:
2.34
Template used: (default or statictoc or contain custom template)
default with small customizations

Actual Behavior:
Is it possible to have the toc automatically generated from the folder structure of my documentation? I have a lot of markdown documentation already organized in folders. I would like docfx to simply build a site that uses the existing organization as the toc. It seems like unnecessary busy work to have to add each of my markdown files to a toc file so that they are visible in the UI.

[StevenTCramer]

When docfx generates the following error:

docfx/src/Microsoft.DocAsCode.Build.TableOfContents/TocResolver.cs

Line 111 in 5531168

var message = $"Unable to find {item.TocHref}. Make sure the file is included in config file docfx.json!";

Instead of that error it would be nice if we could auto generate the toc from the folder structure.

[yufeih]

How would you like to order the files in TOC?

[StevenTCramer]

@yufeih typically a directory lists alphabetical. Would be fine with me.

[yufeih]

Grav uses numbers in file names determine the order, these numbers are removed in URL:

01. page-1.md
02. page-2.md

[Flogex]

How would you like to order the files in TOC?

What about specifying the position of each item in the TOC using a property in the YAML Header?

---
index: 2
---

And if there are two files with the same index or it is not set, they are ordered alphabetically.

[dampee]

Hi, we are doing something for the Umbraco documenation here: https://github.com/dampee/DocFxTocGenerate