← Back to issue list

fix(docs): update starflow intersphinx URL

View original Github issue

Metadata

Project
debcraft
Number
#209
Type
pull request
State
merged
Author
LoweRAM
Labels
—
Created
Updated
Closed

Current evaluation

Merged PR #209 to fix a Sphinx intersphinx warning by updating the starflow inventory URL from the retired canonical-starflow.readthedocs-hosted.com to https://documentation.ubuntu.com/starflow/latest.

Resolution: closed resolved

Reason: The PR was merged, updating the starflow intersphinx URL in docs/conf.py to resolve the Sphinx 404 warning during documentation builds.

Evaluated by: mr-cal-bot

No scores available.

Issue body

🤖 [BEEP BOOP, A BOT WROTE THIS PR - Mistral Large 4, opencode] Fixes the Sphinx warning emitted on every docs build on main: ``` docs/explanation/documentation.rst: WARNING: inventory for external cross-reference not found: 'starflow' intersphinx inventory 'https://canonical-starflow.readthedocs-hosted.com/objects.inv' not fetchable due to <requests.exceptions.HTTPError>: 404 Client Error: Not Found for url: https://documentation.ubuntu.com/starflow/objects.inv ``` The `starflow` intersphinx mapping in `docs/conf.py` points at the retired `canonical-starflow.readthedocs-hosted.com`, which redirects to a 404. The `:external+starflow:ref:`how-to-starcraft-style-guide`` role in `docs/explanation/documentation.rst` therefore cannot resolve. Fix: point the mapping at the live inventory, `https://documentation.ubuntu.com/starflow/latest` (which contains the `how-to-starcraft-style-guide` label). This is the same URL starbase already uses, so it also drops out of the update-starbase merge PR (#203) once this lands. Verified (worktree on `origin/main`, CI-equivalent setup — uv venv with the docs group, then `make docs`): - `make docs` succeeds (`sphinx-build --fail-on-warning`): zero intersphinx warnings (was: inventory not fetchable + cross-reference not found) - The built `docs/_build/explanation/documentation/index.html` links to `https://documentation.ubuntu.com/starflow/latest/how-to/starcraft-style-guide/` Note: this PR is opened from the `LoweRAM/debcraft` fork because the LoweRAM account has read-only access to `canonical/debcraft` (fork PRs are the standard flow for that).

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.6-35b-a3b — closed resolved Merged PR #209 to fix a Sphinx intersphinx warning by updating the starflow inventory URL from the retired canonical-starflow.readthedocs-hosted.com to https://documentation.ubuntu.com/starflow/latest.

Update history

Date Change
merged
updated
created

Related work

  • Related To: debcraft#203 (confidence 90%)

    Mentioned as the update-starbase merge PR that will also use this URL.

Related issues

Issue Project State Summary Similarity
#198 docs: fix intersphinx mapping for starflow craft-grammar merged Merged #198, updating Starflow’s intersphinx URL to https://documentation.ubuntu.com/starflow/latest and fixing the documentation build error.
86%
#6279 docs: update starflow path snapcraft merged Merged docs change (commit 4c84bfb29): intersphinx mapping in docs/conf.py repointed to the versioned Starflow path so links survive Starflow's versioned rollout. Backported to hotfix/9.0 in #6289.
80%
#548 docs: update starflow intersphinx mapping starbase merged Merged PR #548 via commit 7e56723, updating the Starflow intersphinx mapping in docs/conf.py.
79%
#6289 docs: update starflow path snapcraft merged Merged #6289 as f0d85968b into hotfix/9.0, updating the Starflow docs path and incorporating fixes from #6279 and canonical/starbase#551.
72%