← Back to issue list

Document the creation and use of stage-packages filters

View original Github issue

Metadata

Project
craft-parts
Number
#835
Type
issue
State
open
Author
lengau
Labels
Created
Updated
Closed

Current evaluation

Documentation task to write a how-to for register_stage_packages_filter; the function still exists with a confusing docstring implying deprecation, and no how-to has been written. No labels, no comments, no assignee after 725 days.

Suggested action: needs triage

Reason: The issue lacks labels, has no assignee, and shows no sign of being categorised or prioritised despite being filed by a maintainer (lengau). The underlying problem is still present: register_stage_packages_filter exists in craft_parts/callbacks.py with a docstring stating 'This is now deprecated', and no how-to documentation for it exists in docs/how-to/. However, 538 days of inactivity means it needs a maintainer to confirm whether this is still a priority or whether the deprecation note in the docstring should be addressed first.

Impact: 35 Quick Win: 24.5 Staleness: 75 Complexity: 30 Confidence: 80 Support Request: 10

Issue body

### What needs to get done Write a how-to for registering stage-packgaes filters. ### Why it needs to get done The current documentation is only in the auto-generated package reference, and the docstring for that is confusing, as it implies that it is deprecated. https://canonical-craft-parts.readthedocs-hosted.com/en/latest/reference/gen/craft_parts.callbacks.html#craft_parts.callbacks.register_stage_packages_filter

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.8-27b
Impact: 35
Quick Win: 24.5
Staleness: 75
Complexity: 30
Confidence: 80
Support Request: 10
needs triage Documentation task to write a how-to for register_stage_packages_filter; the function still exists with a confusing docstring implying deprecation, and no how-to has been written. No labels, no comments, no assignee after 725 days.
qwen/qwen3.6-35b-a3b
Staleness: 92
Complexity: 15
Confidence: 88
Support Request: 5
close stale Request to add user-facing documentation for registering stage-packages filters, as current auto-generated docs are confusing and imply deprecation. Unassigned, no comments, inactive for over a year.
qwen3.6-35b-a3b-mtp-q6
Staleness: 92
Complexity: 10
Confidence: 85
Support Request: 0
needs triage Documentation task requesting a how-to guide for registering stage-packages filters. Currently lacks maintainer triage, has no comments, and has been inactive for over a year.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 15
Confidence: 75
Support Request: 5
needs triage Create a how-to guide for registering stage-packages filters. Current auto-generated docs are confusing and incorrectly imply deprecation. Open with zero comments, inactive for over six months, awaiting triage and assignment.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.