← Back to issue list

Docs: Interactive builds loop

View original Github issue

Metadata

Project
snapcraft
Number
#5038
Type
issue
State
open
Author
medubelko
Labels
Status: Triaged Type: Bug Type: Documentation
Created
2024-09-13 17:59:26+00:00
Updated
2026-03-20 16:54:43+00:00
Closed

Current evaluation

No evaluation has been recorded for this issue yet.

Issue body

### Bug Description As I [covered recently](https://github.com/canonical/snapcraft/blob/main/HACKING.md?plain=1#L69-L71), interactive builds run in an infinite loop. ### To Reproduce 1. Run: ```bash tox run -e autobuild-docs ``` After it first builds, no issues are detected. 2. Save a change to any RST file in `/docs`. The docs begin rebuilding in a loop. ### Environment System: Ubuntu 24.04 Environment: Snapcraft repo, no LXD/Multipass setup. ### snapcraft.yaml ```yaml - ``` ### Relevant log output ```shell [sphinx-autobuild] Detected change. Rebuilding... [sphinx-autobuild] > sphinx-build -b html /home/med/dev/snapcraft/docs /home/med/dev/snapcraft/docs/_build ``` ### Additional context @tigarmo This might be related to importing docs inside of other docs. Another TA reported similar issues a few months ago and their temporary solution was to exclude some of the content from rebuild. We found others that vouch for this being a possibility: https://github.com/sphinx-doc/sphinx/issues/11556#issuecomment-1667451983. I haven't looked into this deeply, though. If we could get `sphinx-autobuild` to specify what files it detects have changed, this would be easier to diagnose, but even with the `-v` option it merely says `Detected change`.

Evaluation history

No evaluation history available.