Repository navigation
Conversation
We have been testing `SPHINX_PARALLEL` feature flag for some weeks now and we saw some improvement on build times. However, all the projects need to * install `readthedocs-sphinx-ext>=2.1.0` (can be forced with `USE_SPHINX_RTD_EXT_LATEST` flag for now) * do not install any extension that does not support parallel reading * build on `build:large` queue in community (`build:default` has only one CPU) As we are using `-j auto`, enabling it when it's not available won't be an issue and builds should keep working properly.
ericholscher
left a comment
There was a problem hiding this comment.
We should also set this historical_default_true for a while prior to fully removing it, letting us roll it back easier.
|
This one only had 31 projects, maybe we should do a bigger sample before testing with default true. |
Done! /remind me about this in 15 days |
|
I'm marking this as blocked because it causes issues on projects that have This issue was reported at #7394 |
|
This is true for any extension that isn't parallel safe, which is most of them from my experience. I don't think we can default this on, and it needs to be configurable. |
|
Closing this PR for now because there is no safe way to make it always work by default. |
We have been testing
SPHINX_PARALLELfeature flag for some weeks now and we sawsome improvement on build times.
However, all the projects need to
readthedocs-sphinx-ext>=2.1.0(can be forced withUSE_SPHINX_RTD_EXT_LATESTflag for now)build:largequeue in community (build:defaulthas only one CPU)As we are using
-j auto, enabling it when it's not available won't be an issueand builds should keep working properly.