build(docs): update Sphinx Stack to 2.0
Metadata
Current evaluation
Merged in canonical/starbase#537 (commit fafd1fc), upgrading docs to Sphinx Stack 2.0, locking dependencies, removing Starter Pack references, and stopping autobuild loops.
Resolution: closed resolved
Reason: PR #537 was approved and merged into main as commit fafd1fc. It delivers the Sphinx Stack 2.0 upgrade and associated documentation tooling fixes.
Evaluated by: mr-cal-bot
No scores available.
Issue body
* Update docs tooling to Sphinx Stack 2.0 ([see full diff](https://github.com/canonical/sphinx-stack/compare/1.5...2.0)).
* Replace any other references to the 'Starter Pack'
* Lock dependencies
* Fix the autobuild loop by ignoring symlinks and generated dirs with `SPHINX_AUTOBUILD_OPTS`
---
- [x] I've followed the [contribution guidelines](https://github.com/canonical/starbase/blob/main/CONTRIBUTING.md).
- [x] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
~~I've successfully run `make lint && make test`.~~
- [x] I've added or updated any relevant documentation.
~~In documents I changed, I [added a meta description](https://canonical-starflow.readthedocs-hosted.com/how-to/add-a-page-meta-description/) if one was missing.~~
~~I've updated the relevant release notes.~~
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Merged in canonical/starbase#537 (commit fafd1fc), upgrading docs to Sphinx Stack 2.0, locking dependencies, removing Starter Pack references, and stopping autobuild loops. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged Sphinx Stack 2.0 docs upgrade in canonical/starbase#537 (fafd1fc), locking dependencies, removing Starter Pack references, and fixing autobuild loops. | |
| qwen/qwen3.6-35b-a3b | — | — | Merged after three reviewer approvals. Updates documentation tooling to Sphinx Stack 2.0, locks dependencies, replaces legacy references, and resolves an autobuild loop by configuring Sphinx AutoBuild to ignore symlinks and generated directories. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged. Updated documentation tooling to Sphinx Stack 2.0, replaced Starter Pack references, locked dependencies, and resolved the autobuild loop by ignoring symlinks and generated directories. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #497 build(docs): update Sphinx Stack to 2.0 | craft-cli | merged | Merged PR updating documentation tooling to Sphinx Stack 2.0, migrating from .sphinx to docs/_dev, updating conf.py and Makefile, and adding new documentation files. Upstreamed from canonical/starbase#537. | |
| #496 build(docs): update Sphinx Stack to 2.0 | craft-cli | closed | Closed unmerged; superseded by the Starbase synchronization merge commit 21f2ac7, which brought the Sphinx Stack 2.0 docs tooling changes into main. | |
| #275 build(docs): upgrade to Sphinx Stack 2.0 | craft-platforms | closed | Merged as commit 75dff07, upgrading the documentation configuration and dependencies to Sphinx Stack 2.0 after all CI checks passed. | |
| #1252 docs: update dependency sphinx stack to 2.0 | rockcraft | merged | Merged PR #1252 as caf0486f, upgrading and locking docs tooling to Sphinx Stack 2.0, removing Starter Pack references, and updating linter/link-checker settings. | |
| #1215 build(docs): update Sphinx Stack to 2.0 | craft-application | merged | Merged PR migrating docs tooling to Sphinx Stack 2.0: renames .sphinx to _dev, docs-starter-pack to docs-sphinx-stack, switches to sphinx_rerediraffe, adds sphinx-llm and templates. | |
| #275 build(docs): incorporate the latest Sphinx Starter Pack | imagecraft | merged | Merged PR #275 (commit 097e5f5), refreshing the docs build with the latest canonical Sphinx Starter Pack across 23 files; author noted the failing fast-test/build checks were unrelated. | |
| #504 build(deps): update dependency sphinx-sitemap to ==2.6.0 | starbase | merged | Merged in canonical/starbase#504 via commit 22b81ba, pinning sphinx-sitemap to 2.6.0 to prevent unintended sphinx-last-updated-by-git installation and fix the docs build. | |
| #317 build(deps): update dependency canonical-sphinx to ~=0.3.0 | starbase | merged | Renovate PR merged: bumped canonical-sphinx from ~=0.2.0 to ~=0.3.0 in starbase's docs requirements, landing as commit 68ad84a. Later superseded by #420 which moved the pin to ~=0.5.1. | |
| #261 Update Sphinx starter pack | starbase | closed | Updated the Sphinx Starter Pack to 1.3.1 via merged PR #478, including docs Makefile passthrough targets so new projects inherit current documentation improvements and tests. | |
| #24 some general docs improvements | starbase | merged | Merged in canonical/starbase#24, adding Sphinx linting and autobuild, strict docs builds, Ubuntu-font CSS, and renamed docs tox environments. |