Tell sphinx-llm to not run in parallel to fix RTD errors - #622
Conversation
sphinx-llm by default creates a parallel process that touches build files while the main process (or other extensions, like sphinx-tags) could still be using them. This should fix that.
|
Could you provide a specific example of this problem (e.g. a link to a repo or PR that has encountered this issue)? This will have significant build time impact (something a few teams have commented on already) and I would prefer to not make this change if it can be addressed in another way. |
|
Sure thing! And understandable...we've done this for our docs repo, but it might not be the best thing to push out everywhere now that you mention that... https://app.readthedocs.com/projects/canonical-se-docs/builds/4295015/ |
|
I think it would be better for this issue to be documented and this workaround to be noted as a way through, rather than changing the default. It seems likely this would only affect projects that use Sphinx Tags in addition to the default stack (or something similar), which is a small number at this stage. As such I think this should be added to the documentation. |
2 participants
sphinx-llm by default creates a parallel process that touches build files while the main process (or other extensions, like sphinx-tags) could still be using them. This should fix that.
CHANGELOG.mdwith relevant non-documentation file changes?