docs: Document that resources are bound to channels, not revisions.
Metadata
Current evaluation
Documentation issue requesting clarification that resources are bound to channels, not revisions, with a clear example showing the current behavior.
Suggested action: needs triage
Reason: The issue is 4 days old with 0 maintainer comments or responses. While it's a well-written documentation request with a clear reproduction example showing resources are bound to channels rather than revisions, it has not yet been triaged or prioritized by maintainers.
Impact:
40
Quick Win:
32.0
Staleness:
5
Complexity:
20
Confidence:
80
Support Request:
10
Issue body
Resources are bound to channels, not revision. This does not seem to be documented anywhere.
The syntax of `charmcraft release` (e.g. in [publish charm](https://canonical.com/juju/docs/charmcraft/4/howto/manage-charms/#publish-a-charm)) indicates that you pin a resource to a revision:
```
charmcraft release my-awesome-charm --revision=1 --channel=beta--resource someresource:1
```
But that is not the case. I released three revisions with three different resources:
```
0 $ charmcraft release headscale-k8s --revision=15 --channel=edge --resource headscale-image:7
Revision 15 of 'headscale-k8s' released to edge (attaching resources: 'headscale-image' r7)
15:53:12 | m.b@c.c@mboden-laptop | ~
0 $ charmcraft release headscale-k8s --revision=16 --channel=edge --resource headscale-image:8
Revision 16 of 'headscale-k8s' released to edge (attaching resources: 'headscale-image' r8)
15:53:17 | m.b@c.c@mboden-laptop | ~
0 $ charmcraft release headscale-k8s --revision=18 --channel=edge --resource headscale-image:9
Revision 18 of 'headscale-k8s' released to edge (attaching resources: 'headscale-image' r9)
15:53:22 | m.b@c.c@mboden-laptop | ~
```
When deploying with `--revision 15`, the attached resource was image 9.
Having the images bound to channels is fine as well, but it should be clearly documented.
---
*Reported from: https://canonical.com/juju/docs/charmcraft/4/howto/manage-resources/*
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen3.6-35b-a3b-mtp-q6 |
Impact:
40
Quick Win:
32.0
Staleness:
5
Complexity:
20
Confidence:
80
Support Request:
10
|
needs triage | Documentation issue requesting clarification that resources are bound to channels, not revisions, with a clear example showing the current behavior. |
Update history
| Date | Change |
|---|---|
| created |
Related issues
No related issues found above the similarity threshold.