fix(docs): update starflow intersphinx URL
Metadata
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. | |
| #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. | |
| #548 docs: update starflow intersphinx mapping | starbase | merged | Merged PR #548 via commit 7e56723, updating the Starflow intersphinx mapping in docs/conf.py. | |
| #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. |