[TASK] Speed up menu rendering

[jaapio]

In the original template all files in the documentation contained the full menu structure. While not all was ever used. By rendering just the sub menu's when they are active we do improve the speed of rendering drastically. This results in a 80% performance boost for projects like changelog.

[linawolf]

Unfortunarily this would break the menu where you can use the toggle buttons to go to other parts of the docs.

If we put this behind a --fast option or some such it might help local rendering however

[CybotTM]

@jaapio, is this still relevant (with the provided performance patches in phpdocumentor/guides)? If yes, I can have look and overhault the PR.

[jaapio]

Yes this is still a relevant fix. However the changes I did are not valid. Menu's do break this way.

[CybotTM]

Hi @jaapio,

maybe I missed something or did not get the full context, as it seems a lot of intrinsic knowledge is not documented here in the PR, but

IMO this PR is superseded by patches provided at deeper layers: AST caching, template caching, O(1) document lookups, and parallel processing. In upstream phpDocumentor/guides:

• perf: Add caching layer for rendering operations phpDocumentor/guides#1287
• perf: Optimize RST parsing with pattern and instance caching phpDocumentor/guides#1288
• perf: Add DI container caching for faster CLI startup phpDocumentor/guides#1289
• perf: O(1) document entry lookups in ProjectNode phpDocumentor/guides#1293
• feat: Add optional template caching support to EnvironmentBuilder phpDocumentor/guides#1294
• feat: Add PSR-16 caching support to JsonLoader phpDocumentor/guides#1295
• feat: Add incremental build infrastructure for dependency tracking phpDocumentor/guides#1296
• perf: Add parallel processing infrastructure phpDocumentor/guides#1297

This is also where other projects will benefit from it.

So I will focus elsewhere.

[linawolf]

The solution doesnt work as is, we might start a new attempt in the future