← Back to issue list

Define Type: grammar-array

View original Github issue

Metadata

Project
craft-parts
Number
#671
Type
issue
State
open
Author
javierdelapuente
Labels
—
Created
Updated
Closed
—

Current evaluation

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.

Suggested action: close stale

Reason: The 'grammar-array' type no longer appears anywhere in the repo (grep for 'grammar-array' returns no matches); commit 87057b6d 'docs: modify types to be actual variable types (#1055)' replaced such placeholder types with real ones, and part_properties.rst now uses kitbash-field with actual types (e.g. list[str]). The underlying confusion is resolved by the docs rework, so the request is no longer applicable.

Impact: 15 Quick Win: 13.5 Staleness: 70 Complexity: 10 Confidence: 75 Support Request: 40

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
qwen/qwen3.8-27b
Impact: 15
Quick Win: 13.5
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.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 15
Confidence: 85
Support Request: 80
close not a bug Request to document the undefined grammar-array type used in part properties like build-packages and stage-snaps. Open and inactive for over a year, synced to internal Jira, awaiting triage and assignment.

Update history

No update history recorded yet.

Related work

  • Likely Fixed By: craft-parts/craft-parts#1055 (confidence 70%)

    Commit 87057b6d 'docs: modify types to be actual variable types (#1055)' removed placeholder types like grammar-array from the part-properties reference; no 'grammar-array' remains in the codebase.

Related issues

No related issues found above the similarity threshold.