Fwd: Sphinx performance analysis and enhancement

[samuel....@gmail.com]

Forwarded from the sphinx-dev mailing list.

Someone better versed in our build system than myself

might want to chime in.    Kind regards,   --slelievre

---------- read on sphinx-dev ---------
From: danwos
Date: lundi 14 février 2022 à 09:52:17 UTC+1
Subject: Sphinx performance analysis and enhancement
To: sphinx-dev

Dear all,

I'm supporting teams in the automotive industry, which have

Sphinx projects with >15.000 files. ~11.000 are autogenerated,

the rest is handwritten.
The build time is often > 1.5h, which is too much for them.

In the past I already did some performance analysis for Sphinx

extensions, which results in some scripts to setup different test

environments and measure the build times.
https://github.com/useblocks/sphinxcontrib-needs/tree/master/performance

However, I think Sphinx itself maybe has some potential for

performance improvements.

Does anybody have done some analysis already in the past and

could share her/his outcome or ideas for improvements?

My first step would be to define and create a reproducible test setup

for any kind of Sphinx project. Including some performance analysis

features.

(The above linked Sphinx-Needs solution will be a good starting point)

As you see, just some ideas, nothing concrete yet.
So I'm thankful for any kind of help, link or opinion.

Cheers,
Daniel