Define Type: grammar-array
Metadata
Current evaluation
Undefined grammar-array labels were reported in part-properties documentation; current docs use actual variable types, and grammar-array no longer appears in the repository.
Suggested action: close resolved
Reason: Commit 87057b6d (PR #1055), titled "docs: modify types to be actual variable types," replaced the opaque type labels. The current PartSpec fields are defined as concrete types such as list[str], and a repository-wide search finds no remaining grammar-array reference.
Evaluated by: mr-cal-bot
Impact:
25
Quick Win:
20
Complexity:
10
Confidence:
96
Actionability:
90
Issue body
### What needs to get done
At some points in the documentation, like for example in part-properties `build-packages` or `stage-snaps`, the indicated type is `grammar-array` (see for example https://canonical-craft-parts.readthedocs-hosted.com/en/latest/reference/part_properties.html#build-packages).
I cannot find a definition of what "grammar-array" is, I think it would be useful to include it somewhere.
### Why it needs to get done
At least for me it is not totally clear what grammar-array means without looking into the code.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha |
Impact:
25
Quick Win:
20
Complexity:
10
Confidence:
96
Actionability:
90
|
close resolved | Undefined grammar-array labels were reported in part-properties documentation; current docs use actual variable types, and grammar-array no longer appears in the repository. | |
| qwen/qwen3.6-35b-a3b |
Impact:
30
Quick Win:
14
Complexity:
20
Confidence:
60
Actionability:
60
|
needs triage | Documentation gap: grammar-array type used in part-properties (build-packages, stage-snaps) is referenced but not defined anywhere in docs or codebase. | |
| qwen/qwen3.8-27b |
Impact:
15
Quick Win:
14
Staleness:
70
Complexity:
10
Confidence:
75
Support Request:
40
|
close stale | Docs request: part-properties reference shows type 'grammar-array' for keys like build-packages/stage-snaps, but no definition of that type exists. The term is gone from current docs (replaced by real types in #1055), so the request is largely moot. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
85
Complexity:
15
Confidence:
80
Support Request:
10
|
needs triage | Request to document the grammar-array type used in part properties like build-packages. Currently undocumented and unassessed by maintainers for over two years, awaiting triage. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
85
Complexity:
15
Confidence:
75
Support Request:
30
|
needs triage | Documentation request to define the grammar-array type used in part properties. Unlabelled with no maintainer response in over two years. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
canonical/craft-parts#1055
(confidence 97%)
The commit title directly matches replacing the old documentation type labels, and the current tree no longer contains grammar-array.
Related issues
No related issues found above the similarity threshold.