docs: add an application release checklist
Metadata
Current evaluation
Adds a release checklist reference page with patch/minor release procedures and per-app quick links. Also fixes docs/conf.py to include reference in published docs. Has 20 unresolved review comments and 0 reviewers.
Suggested action: needs review
Reason: The PR is awaiting maintainer review with 20 unresolved review comments and 0 reviewers assigned. @mr-cal suggested restructuring the content as a how-to instead of reference since it contains ordered actionable items — this feedback should be addressed before merge. One CI check (contributors) is failing.
Evaluated by: mr-cal-bot
Impact:
25
Quick Win:
8
Complexity:
15
Confidence:
75
Actionability:
40
Issue body
## Summary
Adds a reference page for releasing a Starcraft application, with two checklists and per-app quick links.
- **Patch release**: backport on `hotfix/<major>.<minor>`, tag, candidate build, promote, then merge the release branch back into `main` via a `work/hotfix-merge/<version>` branch.
- **Minor release**: split into *Release to candidate* (hotfix branch merge check, release notes page, tag, Launchpad sync, recipe branch switch, soak, Read the Docs version, calls for testing) and *Promote to stable*.
- **Quick links**: one tab per app (Charmcraft, Debcraft, Imagecraft, Rockcraft, Snapcraft) with Launchpad, Matrix, Discourse, release notes, store, and GitHub links.
Every URL was verified against Launchpad, the Discourse APIs, and each project's `docs/conf.py`.
## Changes outside the new page
- `docs/conf.py`: drops `reference` from `exclude_patterns`, which meant nothing in that directory could be published.
- `docs/index.rst` and `docs/reference/index.rst`: add the reference section and the page to their toctrees.
## Known gaps
- Debcraft has no published docs site, so its tab has no release notes row.
- Matrix rooms were taken from each repo's `docs/conf.py`; Imagecraft's was corrected to `#imagecraft` manually.
## Verification
- `sphinx-lint` clean with `--enable all`.
- `sphinx-build` succeeds with no new warnings.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b |
Impact:
25
Quick Win:
8
Complexity:
15
Confidence:
75
Actionability:
40
|
needs review | Adds a release checklist reference page with patch/minor release procedures and per-app quick links. Also fixes docs/conf.py to include reference in published docs. Has 20 unresolved review comments and 0 reviewers. |
Update history
| Date | Change |
|---|---|
| updated | |
| updated | |
| updated | |
| created |
Related issues
No related issues found above the similarity threshold.