← Back to issue list

docs: add guidance for progressive release pause and resume capability

View original Github issue

Metadata

Project
snapcraft
Number
#6460
Type
issue
State
open
Author
shaloo
Labels
Type: Documentation
Created
Updated
Closed
—

Current evaluation

⚠️ This summary may be outdated — the issue content or evaluation prompts have changed since this evaluation was made.

Documentation request to add progressive-release pause/resume guidance to the manage-revisions-and-releases page; resume uses `snapcraft release ... --progressive nn` with nn above the paused percentage.

Suggested action: needs triage

Reason: The issue is a clear, well-scoped docs request with a specific page and resume command, but it has no maintainer response, assignee, or prioritization yet, so it should be triaged. The existing 'Deliver a progressive release' section (docs/how-to/publishing/manage-revisions-and-releases.rst) indeed covers only start/close and not pause/resume, confirming the gap.

Evaluated by: mr-cal-bot

Impact: 30 Quick Win: 18 Complexity: 20 Confidence: 75 Actionability: 75

Issue body

### Check existing issues - [x] I've verified that this request isn't described by any existing issues. ### Request Describe your request and the problem it solves. Include any relevant context, screenshots, or examples. The existing snapcraft documentation section related to [progressive release ](https://ubuntu.com/docs/snapcraft/9/how-to/publishing/manage-revisions-and-releases/#deliver-a-progressive-release)does not cover pausing and resuming capability. Pausing requires intervention from Stores backend / API call by admins and resume action can be done by the snap publisher using the snapcraft CLI tool To resume: `snapcraft release ... --progressive nn` where nn is > %value at pause time. For example if the progressive release was set to 85%, at the time of resume nn should be 86 or larger. ### Document location Provide the URL or file path of the relevant page.

Evaluation history

Date Model Scores Action Summary
~deepseek/deepseek-pro-latest
Impact: 30
Quick Win: 18
Complexity: 20
Confidence: 75
Actionability: 75
needs triage Documentation request to add progressive-release pause/resume guidance to the manage-revisions-and-releases page; resume uses `snapcraft release ... --progressive nn` with nn above the paused percentage.
stealth/space-bunny-alpha
Impact: 32
Quick Win: 14
Complexity: 25
Confidence: 64
Actionability: 58
needs triage Docs request: add pause/resume guidance for progressive releases to the existing how-to page. Pause is Store-admin-only; resume via `snapcraft release --progressive nn` where nn exceeds the paused percentage. New, unlabelled, no maintainer response yet.
qwen/qwen3.8-27b
Impact: 35
Quick Win: 21
Complexity: 15
Confidence: 80
Actionability: 70
needs triage Docs request to add pause/resume guidance for progressive releases to the snapcraft how-to page. The feature exists in code (paused field in channel map) but is undocumented. New, untriaged, no maintainer activity.

Update history

Date Change
updated
updated
created

Related issues

No related issues found above the similarity threshold.