doc: use the Pebble docs
Metadata
Current evaluation
Docs task: rework explanation/pebble.rst to lean on the official Pebble docs (readthedocs/ubuntu.com) instead of duplicating content and linking to the Pebble GitHub repo; partially addressed by #779 but the GitHub link remains.
Suggested action: keep open
Reason: Still valid and unaddressed: at HEAD, docs/explanation/pebble.rst:87 still defines `.. _Pebble: https://github.com/canonical/pebble` (and docs/tutorial/node-app.rst:156 does the same), exactly the redirect @asanvaq flagged in the 2025-11-21 comment. Commit f5532efe / PR #779 only repointed the layer-specification links (intersphinx 'pebble' mapping already points at ubuntu.com/docs/pebble in docs/conf.py:326), so the page content reshaping and the docs-link redirect remain outstanding; the issue is labelled and maintainer-owned, so it stays open despite its age.
Evaluated by: mr-cal-bot
Issue body
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha |
Impact:
26
Quick Win:
9
Complexity:
42
Confidence:
78
Actionability:
62
|
keep open | Docs task: rework explanation/pebble.rst to lean on the official Pebble docs (readthedocs/ubuntu.com) instead of duplicating content and linking to the Pebble GitHub repo; partially addressed by #779 but the GitHub link remains. | |
| stealth/space-bunny-alpha |
Impact:
28
Quick Win:
13
Complexity:
30
Confidence:
82
Actionability:
68
|
keep open | docs/explanation/pebble.rst still duplicates Pebble feature prose and its `Pebble`_ link points at the GitHub repo; maintainers want the page reshaped to rely on the new official Pebble docs (plus a comment on redirecting users there). | |
| qwen/qwen3.6-35b-a3b |
Impact:
25
Quick Win:
18
Complexity:
15
Confidence:
85
Actionability:
85
|
keep open | Update Pebble explanation page to link to official Pebble docs instead of GitHub repo | |
| qwen/qwen3.8-27b |
Impact:
30
Quick Win:
22
Staleness:
55
Complexity:
25
Confidence:
72
Support Request:
5
|
keep 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. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
75
Complexity:
15
Confidence:
80
Support Request:
0
|
keep open | Update explanation/pebble.rst to link to official Pebble documentation instead of the GitHub repo. Task is clearly scoped but has been inactive for over 200 days. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
65
Complexity:
15
Confidence:
85
Support Request:
0
|
keep open | Documentation update to redirect Pebble references to official docs instead of GitHub repo. Currently awaiting implementation after maintainer request and recent contributor comment. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
70
Complexity:
15
Confidence:
85
Support Request:
0
|
keep open | Documentation update to redirect users from the GitHub repo to the official Pebble documentation and align the explanation page with the new docs. Currently awaiting implementation. |
Update history
No update history recorded yet.
Related work
-
Related To:
canonical/rockcraft#779
(confidence 72%)
PR merged as f5532efe ('docs: update link to Pebble layer specification') already updated the Pebble RTD links in six files, partially covering this issue's link-cleanup goal but not the page reshape or the GitHub redirect.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1058 docs: referencing Pebble documentation | rockcraft | open | Docs-only: updates the Pebble hyperlink target in docs/explanation/pebble.rst from the GitHub repo to the official Pebble docs, plus two typo fixes (+2/-2). Partially addresses #737; open 286 days, no reviewers or comments. | |
| #847 docs: update pebble page and add references to pebble docs | rockcraft | open | Docs-only (+21/-20, 7 files): rewrites docs/explanation/pebble.rst to focus on container/rock info and links to official Pebble docs. Changes requested, 2 unresolved comments, idle ~295 days. | |
| #327 docs: rewrite the explanation section | rockcraft | merged | Merged as 0e36ee79, rewriting docs for Pebble, Chisel, rocks, and overlay steps while restoring header styling and resolving #337 and #348. | |
| #983 docs: update links | rockcraft | merged | Merged documentation cleanup that migrated Pebble links to intersphinx, converted internal links to Sphinx references, and refreshed redirected external URLs. |