Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Improve the documentation both visually and content-wise.
List of changes:
importlib.reload
for reloading modules sphinx-doc/sphinx#11679 (also look at Sphinx 7.2.5 breaks with PyO3: "modules may only be initialized once per interpreter process" sphinx-doc/sphinx#11662).Hopefully we will be able to switch to sphinx 7.2.6 soon
There is still one major compatibility problem with
sphinx-tabs
(required byenum-tools[sphinx]
). For some reasonsphinx-tabs
requiresdocutils
0.18.* but most of the other packages specifically avoid 0.18.* and 0.19.* as they are known to be buggy. Right now everything we are using is compatible with docutils 0.20.* except fromsphinx-tabs
.I've checked and
sphinx-tabs
doesn't seem to complain if we force the installation ofdocutils
0.20.*There is an open request to remove the strict (useless?) requirement of docutils from sphinx-tabs executablebooks/sphinx-tabs#171 but since they will address the issue we will still have to rely on manually forcing the installation of docutils 0.20.*
Example of a standard installation: