docs: update dependency sphinx stack to 2.0
Metadata
Current evaluation
Merged. Updates docs tooling to Sphinx Stack 2.0, replaces Starter Pack references, locks dependencies, and adjusts linter and link checker settings. Initial CI failures from external links and network issues were resolved prior to merge.
Suggested action: —
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
- Ignore the docs/_dev/ directory when running the Sphinx linter
- Configure the link checker to use the more modern timeout reporting
---
- [x] I've followed the [contribution guidelines](https://github.com/canonical/rockcraft/blob/main/CONTRIBUTING.md).
- [x] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
- [x] I've successfully run `make lint && make test`.
- [ ] 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 |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Merged. Updates docs tooling to Sphinx Stack 2.0, replaces Starter Pack references, locks dependencies, and adjusts linter and link checker settings. Initial CI failures from external links and network issues were resolved prior to merge. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
10
Complexity:
15
Confidence:
85
|
keep open | Updates documentation tooling to Sphinx Stack 2.0, locks dependencies, and adjusts linter/link checker configs. Currently blocked by ReadTheDocs network issues causing CI failures. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #537 build(docs): update Sphinx Stack to 2.0 | starbase | merged | 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. | |
| #275 build(docs): incorporate the latest Sphinx Starter Pack | imagecraft | merged | Merged the latest Sphinx Starter Pack into the documentation build configuration. Approved by three reviewers. Initial CI failures on fast tests and builds were deemed unrelated by the maintainer, and the changes were successfully merged across 23 files. | |
| #527 build(deps): update dependency sphinx-lint to v1 | craft-application | merged | Merged automated dependency update upgrading sphinx-lint from v0.9.1 to v1.0.0. The pull request passed CI checks, received approval from two reviewers, and was successfully merged. | |
| #229 build(deps): update dependency sphinx-lint to v1 | craft-store | merged | Merged automated dependency update upgrading sphinx-lint from v0.9.1 to v1.0.0. Approved by two reviewers, passed CI checks, and applied with a minimal two-file change. | |
| #48 build(deps): update dependency sphinx-lint to v1 | craft-grammar | merged | Merged dependency update for sphinx-lint from v0.9.1 to v1.0.0. The change passed CI checks and received approval, successfully upgrading the project's linting tool. | |
| #300 docs: refactor documentation for sphinx-starter-pack | rockcraft | merged | Merged documentation refactoring to align with sphinx-starter-pack. Approved by three reviewers and passed CI. Modified 28 files (+351/-63) to standardize structure, validate with pylint, shellcheck, and sphinx, and simplify future integration. | |
| #883 build(deps): update dependency sphinxcontrib-devhelp to v2 (main) | craft-parts | merged | Merged automated dependency update upgrading sphinxcontrib-devhelp from v1.0.6 to v2.0.0. Approved by two reviewers, passed CI checks, and merged to the main branch. | |
| #282 build(deps): update dependency sphinx-lint to v1 | craft-cli | merged | Merged an automated dependency update upgrading sphinx-lint from v0.9.1 to v1.0.0. Approved by two reviewers, passed CI checks, and modified a single file. |