docs: fix version on 'latest'
Metadata
Current evaluation
Merged PR updates Read the Docs slug handling to fix version display on the 'latest' branch. Local, PR, and branch builds now show major/minor versions, while 'latest' displays 'dev'. Approved by reviewers and passed all CI checks.
Suggested action: —
No scores available.
Issue body
With this change, all local, PR, and branch builds will show the major and minor version in the docs title. The only exception is the 'latest' branch build, which will show 'dev' as the version.
This change was brought about by the simplification of our RTD version slugs.
You can check the PR branch versioning at https://canonical-snapcraft--6387.com.readthedocs.build/6387/.
You can check branch versioning on [the private RTD branch I created](https://ubuntu.com/docs/snapcraft/test/).
---
- [X] I've followed the [contribution guidelines](https://github.com/canonical/snapcraft/blob/main/CONTRIBUTING.md).
- [X] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
- [ ] 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 PR updates Read the Docs slug handling to fix version display on the 'latest' branch. Local, PR, and branch builds now show major/minor versions, while 'latest' displays 'dev'. Approved by reviewers and passed all CI checks. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
5
Confidence:
95
|
needs review | Updates documentation versioning logic for ReadTheDocs builds to correctly display major/minor versions, except for the 'latest' branch which shows 'dev'. Approved by 2 reviewers with all CI checks passing. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
0
Complexity:
5
Confidence:
90
|
needs review | Fixes documentation versioning to show major/minor versions on all builds except 'latest', which displays 'dev'. Aligns with RTD slug simplification. CI passes, awaiting review. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
10
Confidence:
90
|
needs review | Updates documentation title to show major/minor version for local and branch builds, aligning with simplified RTD slugs. All CI checks pass. Awaiting maintainer review. |
Update history
| Date | Change |
|---|---|
| updated | |
| updated | |
| updated | |
| created |
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #2830 docs: fix version string for 'latest' | charmcraft | merged | Merged documentation fix correcting the version string for the 'latest' branch build. Updates ReadTheDocs slug handling to display major/minor versions for local and branch builds, while 'latest' shows 'dev'. All CI checks passed. | |
| #2831 docs: fix version string for 3.x | charmcraft | merged | Merged docs fix for 3.x version string. Local, PR, and branch builds now show major and minor version in the title, while latest shows 'dev'. Aligns with simplified Read the Docs slugs. Approved and merged. | |
| #1334 docs: fix version string on latest | rockcraft | merged | Merged documentation fix updating version string display. Local, PR, and branch builds now show major and minor versions, while the latest branch displays dev. Aligns with simplified RTD version slugs. | |
| #588 docs: fix version in title | starbase | merged | Merged documentation update correcting version display in titles. Builds now show major and minor versions, with latest displaying dev. Approved by two reviewers and passed all CI checks. | |
| #2832 docs: fix version string for 4.x | charmcraft | merged | Merged. Updated documentation to correctly display major and minor version strings for local, PR, and branch builds, reserving 'dev' for the latest branch. Approved by one reviewer with all CI checks passing. | |
| #6390 docs: fix version in Snapcraft 8 | snapcraft | merged | Merged documentation update fixing version display in Snapcraft 8. Aligns RTD version slugs to show major/minor versions for local and branch builds, with 'latest' displaying 'dev'. Approved by reviewers and merged. | |
| #1335 docs: fix version string for 1.x | rockcraft | merged | Merged to a hotfix branch, fixing 1.x documentation version strings to show major.minor locally and in branches, with latest showing dev. Approved by three reviewers and passed all CI checks after clarifying its scope relative to PR 1334. | |
| #6295 docs: fix version numbering | snapcraft | merged | Merged documentation fix aligning ReadTheDocs version numbering with the new branch-based release policy. Incorporated reviewer feedback to refactor conditional logic and add comments. Updated version detection for main, hotfix, and PR branches. | |
| #586 docs: fix incorrect version in documentation | rockcraft | merged | Merged to resolve #584. Configured ReadTheDocs to fetch tags and updated non-release documentation to display dev instead of misleading release strings. Approved by two reviewers with passing CI. | |
| #2787 docs: fix versioning logic | charmcraft | merged | Merged. Fixes branch-based documentation build versioning logic by correcting version name generation. Passed all CI checks and received reviewer approval. |