ci: add RTD release workflow
Metadata
Current evaluation
Adds a GitHub Actions workflow to automate ReadTheDocs version management and redirects for releases. CI passing, awaiting author response to 2 review comments.
Suggested action: keep open
Reason: The PR has 2 unresolved review comments (changes_requested status) and the author hasn't responded yet. The PR should be kept open until the author addresses the feedback before it can be re-reviewed.
Evaluated by: mr-cal-bot
Impact:
50
Quick Win:
10
Complexity:
30
Confidence:
70
Actionability:
30
Issue body
Adds a callable workflow to automate the creation of hotfix branches, RTD versions, and redirects:
## Behavior
- Major versions:
- creates a hotfix branch
- activates the branch's RTD version with slug `<major>`
- sets new version as the project default
- redirects `<major>.0` and `<major>.0.0` to `<major>`
- Minor versions:
- creates a hotfix branch
- deactivates the previous minor version after changing its slug to `<major>.<minor>` (to free up the `<major>` slug)
- activates the new hotfix branch's RTD version with slug `<major>`
- sets new version as the project default
- redirects `<major>.<minor>` and `<major>.<minor>.0` to `<major>`
- Patch versions:
- redirects `<major>.<minor>.<patch>` to `<major>`
## Validation
I tested every case manually on my fork of Snapcraft. [These tags](https://github.com/jahn-junior/snapcraft/releases), pushed one by one, resulted in [this RTD project](https://app.readthedocs.com/projects/canonical-ecoldi-test/)'s active versions and redirects without any manual intervention.
## AI disclosure
A good chunk of this workflow was implemented by Claude Sonnet 5, with lots of guidance on how the steps and API calls should look.
I wrote this PR description myself though ;)
---
- [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/).
- [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 |
Impact:
50
Quick Win:
10
Complexity:
30
Confidence:
70
Actionability:
30
|
keep open | Adds a GitHub Actions workflow to automate ReadTheDocs version management and redirects for releases. CI passing, awaiting author response to 2 review comments. | |
| qwen/qwen3.6-35b-a3b |
Impact:
45
Quick Win:
23
Complexity:
35
Confidence:
75
Actionability:
80
|
needs review | Adds a GitHub Actions workflow to automate ReadTheDocs version management and redirects for releases. CI passing, awaiting maintainer review. | |
| qwen/qwen3.6-35b-a3b |
Impact:
45
Quick Win:
22
Complexity:
25
Confidence:
60
Actionability:
65
|
needs review | Adds a GitHub Actions workflow to automate ReadTheDocs version management and redirects for releases. CI passing, awaiting maintainer review. | |
| qwen/qwen3.6-35b-a3b |
Impact:
35
Quick Win:
17
Complexity:
30
Confidence:
75
Actionability:
70
|
needs review | Adds a new GitHub Actions workflow to automate ReadTheDocs version management and redirects for releases. CI passing, awaiting maintainer review. |
Update history
| Date | Change |
|---|---|
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| created |
Related issues
No related issues found above the similarity threshold.