Testing TypeDoc with 25K Markdown files

[ankudinov]

I'm evaluating TypeDoc as a framework to document a large schema. As a the default JS format is not flexible enough, I'm simply building a lot of Markdown files and nest them according to the data model path. This results in ~25K files generated.
Site builds fine and works well in general. However there is a noticeable lag I can observe when navigating.
Based on browser, OS and other factors it looks a bit different. But usually it's either:

• a lag between click and new page content displayed
• Left side panel showing "loading" while main content is already visible

The lag may not occur every single time.

One obvious thing - I was trying with "searchInDocuments": true disabled. Don't see any significant difference in performance.
Overall search works great once page is loaded even with large index size.

I don't have any formal testing around this setup yet. But appreciate ideas on optimization and root causing the lag.
The Chrome dev tools do not show anything terrible.

Check the generated site here.

[ankudinov]

And here is the workflow to build it

[ankudinov]

Looks like the key problem is that left menu is a long and nested sequence of static

elements, that has to be loaded at once. Obviously this takes time with significant number of nested elements.
Is there a smarter way in TypeDoc to load the leftmost menu? Or should I submit an issue as this doesn't look like a scalable way to build it.

[Gerrit0]

Yeah, that makes sense... I think it's a reasonable request that TypeDoc only add elements for the portions of the navigation which are open.