← Back to issue list

docs: add new guide on when to use overlay and stage packages

View original Github issue

Metadata

Project
rockcraft
Number
#849
Type
pull request
State
open
Author
alesancor1
Labels
Type: Documentation
Created
Updated
Closed
—

Current evaluation

Adds a new how-to guide comparing overlay-packages vs stage-packages (5 files, +215 lines). Changes requested with 37 unresolved review comments; author unresponsive for ~9 months. Target path docs/how-to/rocks/ no longer exists after docs reorganization.

Suggested action: close stale

Reason: The reviewer requested changes (37 unresolved comments) and the author has not responded in 263 days, far exceeding the 3-month threshold. Additionally, the target path docs/how-to/rocks/ has been reorganized (now docs/how-to/web-app-rocks/ and other structures), so the PR would need to be substantially reworked. The underlying need (issue #334) remains open, so a new PR targeting the current docs structure could be opened if desired.

Impact: 30 Quick Win: 25.5 Staleness: 78 Complexity: 15 Confidence: 72

Issue body

- [x] Have you followed the guidelines for contributing? - [x] Have you signed the [CLA](http://www.ubuntu.com/legal/contributors/)? - [x] Have you successfully run `make lint && make test`? --- Closes #334 This PR adds a new guide about the differences between overlay and stage steps, more specifically `overlay-packages` and `stage-packages`. --- See the guide [here](https://canonical-ubuntu-documentation-library--849.com.readthedocs.build/rockcraft/en/849/how-to/rocks/overlay-vs-stage-packages/)

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 30
Quick Win: 25.5
Staleness: 78
Complexity: 15
Confidence: 72
close stale Adds a new how-to guide comparing overlay-packages vs stage-packages (5 files, +215 lines). Changes requested with 37 unresolved review comments; author unresponsive for ~9 months. Target path docs/how-to/rocks/ no longer exists after docs reorganization.
qwen/qwen3.6-35b-a3b
Staleness: 75
Complexity: 15
Confidence: 85
needs review Adds a new documentation guide explaining the differences between overlay and stage packages. Currently under review with 37 unresolved comments and a changes-requested status. Last activity was 222 days ago.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 15
Confidence: 70
close stale Adds a documentation guide comparing overlay and stage packages. The PR has been inactive for over 7 months with zero maintainer comments or review activity.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 10
Confidence: 85
close stale Adds a documentation guide comparing overlay and stage packages. The PR is ready but has been inactive for over six months with no maintainer feedback.
qwen3.6-35b-a3b-mtp-q6
Staleness: 80
Complexity: 5
Confidence: 60
needs review Documentation update adding a guide comparing overlay and stage packages. Open for 445 days with zero comments and no recent activity, currently stale and awaiting review.

Update history

No update history recorded yet.

Related work

  • Caused By: canonical/rockcraft#334 (confidence 90%)

    PR body explicitly states 'Closes #334' which documents the ca-certificates/stage-packages limitation; issue is still open with maintainers noting doc updates are on their backlog.

Related issues

Issue Project State Summary Similarity
#1175 docs: add a how-to for pro rocks rockcraft merged Merged documentation update adding a how-to guide for pro rocks. Approved by two reviewers and passed most CI checks. The change adds 73 lines across three files to the project documentation.
70%