`prime` and `stage` key reference should be fleshed out
Metadata
Current evaluation
Docs gap: the `prime` and `stage` part-property reference pages lack examples and value semantics (e.g. `-` for exclusions). Filed by a maintainer, acknowledged by a second maintainer, but no labels/assignee and no doc update since.
Suggested action: needs triage
Reason: No labels, assignee, or PR reference the issue, and the last activity is a 2024-12-04 comment from @tmihoc expanding the scope to value descriptions, not a fix. The referenced doc page still exists in the docs tree, so the gap is likely still open, but it has sat unlabelled for ~18 months and needs a maintainer to confirm scope before work.
Impact:
35
Quick Win:
29.75
Staleness:
70
Complexity:
15
Confidence:
55
Support Request:
10
Issue body
### What needs to get done
https://canonical-craft-parts.readthedocs-hosted.com/en/latest/common/craft-parts/reference/part_properties.html#stage
This should at least include an example or two of including only certain files or including some files.
### Why it needs to get done
@tmihoc pointed this out due to some user questions on Charmcraft
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.8-27b |
Impact:
35
Quick Win:
29.75
Staleness:
70
Complexity:
15
Confidence:
55
Support Request:
10
|
needs triage | Docs gap: the `prime` and `stage` part-property reference pages lack examples and value semantics (e.g. `-` for exclusions). Filed by a maintainer, acknowledged by a second maintainer, but no labels/assignee and no doc update since. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
85
Complexity:
10
Confidence:
80
Support Request:
5
|
keep open | Documentation improvement request to add examples and value descriptions for prime and stage keys. Acknowledged by maintainers but inactive for over a year. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
85
Complexity:
15
Confidence:
80
Support Request:
5
|
keep open | Request to improve documentation for the prime and stage keys in craft-parts by adding examples and clarifying path syntax for inclusion and exclusion. Currently unlabelled and awaiting implementation. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
85
Complexity:
15
Confidence:
80
Support Request:
10
|
close stale | Improve craft-parts documentation for prime and stage properties by adding file inclusion and exclusion examples, plus value descriptions. Open issue with an internal ticket created, currently inactive and awaiting implementation. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #456 Explain how `stage` and `prime` work in the docs | craft-parts | open | Docs request to explain stage/prime fileset semantics and defaults. Open 1201 days with only a bot Jira-sync comment; related issue #921 on the same topic is still open, so the gap persists. |