Update Sphinx starter pack
Metadata
Current evaluation
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.
Resolution: closed resolved
Reason: PR #478 was merged; commit c47c166 upgraded canonical-starter-pack to 1.3.1, and e94f190 added the documentation Makefile passthrough targets. The maintainer closed #261 stating, "Resolved with #478."
Evaluated by: mr-cal-bot
No scores available.
Issue body
We're using an old version of the RTD starter pack. There are several improvements to the current version, and more to come.
All new projects are inheriting this old base, and none of our developers are able to access these improvements and tests.
We should update the base in the next cycle all so that docs benefit from these developments.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | 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. | |
| stealth/space-bunny-alpha | — | closed resolved | Updated the Sphinx Starter Pack to 1.3.1 in canonical/starbase PR #478, merged into the default branch so new projects inherit current docs improvements and tests. | |
| qwen/qwen3.6-35b-a3b | — | — | Updated the Sphinx starter pack to the latest version. The request was resolved and merged via pull request #478, enabling all projects to inherit recent improvements and tests. | |
| qwen/qwen3.6-35b-a3b | — | — | Updated the RTD Sphinx starter pack to the latest version to enable new improvements and tests. The request was resolved and merged via pull request #478. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Merged via pull request #478, updating the outdated Read the Docs Sphinx starter pack to incorporate recent improvements and tests. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
canonical/starbase#478
(confidence 100%)
Merged PR that performed the Starter Pack upgrade and was explicitly cited as the resolution.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #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. | |
| #537 build(docs): update Sphinx Stack to 2.0 | starbase | merged | Merged in canonical/starbase#537 (commit fafd1fc), upgrading docs to Sphinx Stack 2.0, locking dependencies, removing Starter Pack references, and stopping autobuild loops. | |
| #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. | |
| #300 docs: refactor documentation for sphinx-starter-pack | rockcraft | merged | Merged PR #300 in commit 66911e8e, refactoring 28 documentation files to align Rockcraft with sphinx-starter-pack and ease future integration. | |
| #496 docs: autobuild loops in apps | starbase | closed | Sphinx docs autobuild loop was fixed by merged PR #523 (commit 25d7d15), updating Starter Pack documentation variables. | |
| #1341 chore: rename starter pack submodule | craft-parts | merged | Merged in #1341 via 1803cfa8, renaming the documentation submodule to sphinx-docs-starter-pack and updating references and contributor resync instructions. | |
| #1112 build(docs): refresh starter pack implementation | rockcraft | merged | Merged in PR #1112 via commit 61e6bf3a, refreshing the docs starter pack, adding a wordlist, local docs-auto serving, and docs-lint coverage. | |
| #562 docs: update to canonical-sphinx | craft-providers | merged | Merged PR (commit 9897239) enabled the canonical-sphinx docs extension and removed sphinx-docs-starter-pack submodule references in craft-providers. Leftover submodule dir was later cleaned up in #713. | |
| #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. | |
| #197 chore: use Canonical's sphinx-docs-starter-pack | craft-cli | merged | Merged PR #197 (77a3b26) adopted Canonical's Sphinx starter pack, moved documentation dependencies to a requirements file, and fixed #187. |