Improve article "Parts and Steps"
Metadata
Current evaluation
Clarify the Parts and Steps reference for newcomers by explaining Craft Parts and “project”; the shared wording remains generic, with no maintainer response.
Suggested action: needs triage
Reason: The request identifies two concrete ambiguities and links the exact page. The current Rockcraft page includes the shared Craft Parts reference, whose opening still says “Parts and steps define the lifecycle of a project” without defining “project”; no comments or maintainer response show that the issue has been assessed, so it should be triaged rather than closed.
Evaluated by: mr-cal-bot
Impact:
35
Quick Win:
21
Complexity:
30
Confidence:
91
Actionability:
85
Issue body
### Request type
Enhancement
### What needs to get done
This is a request to improve the [Parts and Steps](https://documentation.ubuntu.com/rockcraft/en/latest/reference/parts_steps/) article.
The following points are not clear for a new rock developer:
1. `craft-parts` in the first phrase. Are we talking about [Parts](https://documentation.ubuntu.com/rockcraft/en/latest/explanation/parts/), or is this a new concept?
2. The word _project_ in the article is generic and is not clear in this context. The reader would not know if we’re talking about a generic software project, or if this is a concept related to rocks or rockcraft.
Suggestions:
1. If `craft-parts` means [Parts](https://documentation.ubuntu.com/rockcraft/en/latest/explanation/parts/), link to it. Else, provide more information.
2. Clarify what _project_ is. Is this a term we use when building rocks?
### Documentation location
https://documentation.ubuntu.com/rockcraft/en/latest/reference/parts_steps/
### Additional information
_No response_
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha |
Impact:
35
Quick Win:
21
Complexity:
30
Confidence:
91
Actionability:
85
|
needs triage | Clarify the Parts and Steps reference for newcomers by explaining Craft Parts and “project”; the shared wording remains generic, with no maintainer response. | |
| qwen/qwen3.6-35b-a3b |
Impact:
30
Quick Win:
19
Complexity:
10
Confidence:
70
Actionability:
70
|
needs triage | Documentation improvement request to clarify craft-parts reference and project terminology in the Parts and Steps article for new rock developers. | |
| qwen/qwen3.8-27b |
Impact:
30
Quick Win:
22
Staleness:
55
Complexity:
25
Confidence:
75
Support Request:
15
|
needs triage | Request to clarify two ambiguous terms in the rockcraft 'Parts and Steps' reference doc: link 'craft-parts' to the Parts concept and define 'project'. Doc still contains the same generic wording; no maintainer response in 788 days. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
85
Complexity:
15
Confidence:
85
Support Request:
5
|
needs triage | Documentation enhancement request to clarify terminology like craft-parts and project in the Parts and Steps article. Currently untriaged with no maintainer comments after 222 days of inactivity. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
85
Complexity:
10
Confidence:
85
Support Request:
0
|
needs triage | Documentation enhancement request to clarify terminology like craft-parts and project in the Parts and Steps article. Open for over two years with no maintainer response. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
85
Complexity:
10
Confidence:
90
Support Request:
10
|
needs triage | Documentation enhancement request to clarify terminology like craft-parts and project in the Parts and Steps article. Unassigned, no maintainer comments, open for two years. |
Update history
No update history recorded yet.
Related issues
No related issues found above the similarity threshold.