Skip to content

Conversation

mrdoob
Copy link
Contributor

@mrdoob mrdoob commented Oct 6, 2025

Q A
Bug fix? yes
New feature? no
Breaking change? no
Deprecations? no
Tests added? no
Fixed issues comma-separated list of issues fixed by the pull request, if any
License Apache-2.0

We're trying to adopt JSDoc in Three.js and one of the issues we're facing is that it takes 2 minutes to generate the docs.

I used Claude to profile the build script down to JSDoc's own code to try to pin point where the bottleneck was and eventually we figured out that getAncestors() was the culprit. After this optimization the docs take only 16 seconds to generate.

Please note that I've not studied the code myself but the docs generate as they used to.

/fyi @Mugen87 @donmccurdy @WestLangley @Methuselah96 @DefinitelyMaybe

@hegemonic hegemonic merged commit de12f99 into jsdoc:main Oct 8, 2025
5 checks passed
@hegemonic
Copy link
Contributor

Makes sense to me! I'll backport this fix to JSDoc 4.x and release a new version shortly.

@mrdoob mrdoob deleted the patch-1 branch October 8, 2025 02:47
hegemonic added a commit that referenced this pull request Oct 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants