← Back to issue list

docs: update pebble page and add references to pebble docs

View original Github issue

Metadata

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

Current evaluation

Docs-only PR updating the Pebble explanation page to reference official Pebble docs and cross-linking Pebble mentions on other pages (7 files, +21/-20). Review requested changes 263 days ago; author never responded; same goal pursued in newer PR #1058.

Suggested action: close stale

Reason: A reviewer requested changes with 2 unresolved comments and the author has not responded in ~8.7 months (last activity 263 days ago, 0 comments), far exceeding the 3-month threshold for unaddressed feedback. The core goal — pointing the Pebble page at the official Pebble docs — is now being pursued in the newer, more focused PR rockcraft#1058, so this older 7-file PR is superseded and no longer the right vehicle.

Impact: 20 Quick Win: 18.0 Staleness: 75 Complexity: 10 Confidence: 80

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`? --- This PR adds references to [pebble docs](https://documentation.ubuntu.com/pebble/) in the Pebble page inside rockcraft documentation. This page only keeps the information from pebble related to container images and rocks. Additionally, other pages have been modified so when Pebble is mentioned it links to the pebble page. --- See built page here: (waiting CI)

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 20
Quick Win: 18.0
Staleness: 75
Complexity: 10
Confidence: 80
close stale Docs-only PR updating the Pebble explanation page to reference official Pebble docs and cross-linking Pebble mentions on other pages (7 files, +21/-20). Review requested changes 263 days ago; author never responded; same goal pursued in newer PR #1058.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 10
Confidence: 90
close stale Updates documentation to add references to external Pebble docs and links other pages to the Pebble page. Currently marked changes_requested with 2 unresolved review comments and no recent activity.
qwen3.6-35b-a3b-mtp-q6
Staleness: 70
Complexity: 10
Confidence: 85
close stale Updates rockcraft documentation to add cross-references and links to external pebble docs. Currently inactive for over six months with no maintainer feedback or CI status.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 10
Confidence: 85
close stale Updates Pebble documentation with external references and internal cross-links. Currently inactive for over a year with no maintainer feedback or CI results.
qwen3.6-35b-a3b-mtp-q6
Staleness: 75
Complexity: 10
Confidence: 60
needs review Updates rockcraft documentation to consolidate Pebble content, adds references to official pebble docs, and links related pages. Open PR from an external contributor, inactive for 186 days, awaiting review and CI checks.

Update history

No update history recorded yet.

Related work

  • Related To: rockcraft#1058 (confidence 80%)

    Newer open PR that makes the same core change (linking docs/explanation/pebble.rst to the official Pebble documentation page) in a 2-line diff, superseding this PR's main goal.

  • Related To: rockcraft#737 (confidence 70%)

    Open issue 'doc: use the Pebble docs' requesting the Pebble page link to official Pebble docs; this PR appears to be its implementation attempt.

Related issues

Issue Project State Summary Similarity
#1058 docs: referencing Pebble documentation rockcraft open Updates the Pebble link in docs/explanation/pebble.rst from the GitHub repo to the official Pebble documentation page, plus minor spelling fixes. 2-line change, unreviewed, CI mostly green with one unrelated snap-tests failure.
83%
#327 docs: rewrite the explanation section rockcraft merged Merged documentation rewrite detailing Pebble, chisel, rocks, and overlay-step explanations. Resolved issues #337 and #348 and corrected broken documentation header styling.
76%
#737 doc: use the Pebble docs rockcraft open Doc improvement to reshape the Pebble explanation page to rely on official Pebble docs. Intersphinx mapping updated to new Pebble docs URL, but the page's main Pebble link still points to GitHub and the page hasn't been reshaped.
76%
#304 Pebble doc and test updates rockcraft merged Merged updates to Pebble documentation and spread tests. Fixed formatting issues and aligned content with recent Pebble features like --args. Approved by three reviewers and passed CI checks across ten files.
75%
#779 Update link to Pebble layer specification rockcraft merged Merged updates to the Pebble layer specification documentation, redirecting links to the new official docs site. Approved by two reviewers across six modified files.
73%