← Back to issue list

Documentation for advanced grammar for sources

View original Github issue

Metadata

Project
snapcraft
Number
#1688
Type
issue
State
closed
Author
sergiusens
Labels
Created
Updated
Closed

Current evaluation

Documentation for advanced grammar in snapcraft.yaml was added to the canonical-docs/snappy-docs repository. The syntax update pull request was reviewed and merged, fulfilling the request to document grammar expansion for strings and sources.

Suggested action:

No scores available.

Issue body

Estimate: 1 day Snapcraft currently has a grammar that allows for behavior to change based on, for example, the host architecture. The use of this grammar is slowly making its way across the snapcraft.yaml. Currently the only items supported are lists (e.g. stage-packages and build-packages). Adding support for strings is required to support further expansion (e.g. making the source key grammar-powered).

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.6-35b-a3b Documentation for advanced grammar in snapcraft.yaml was added to the canonical-docs/snappy-docs repository. The syntax update pull request was reviewed and merged, fulfilling the request to document grammar expansion for strings and sources.
qwen/qwen3.6-35b-a3b Resolved via external documentation update. Grammar syntax details were merged into the canonical-docs/snappy-docs repository, adding string support and advanced examples to the build-snaps syntax page.
qwen/qwen3.6-35b-a3b Grammar documentation for snapcraft.yaml sources was added to the syntax page. Changes were merged via canonical-docs/snappy-docs pull request 306, fulfilling the request to expand grammar support beyond lists.
qwen3.6-35b-a3b-mtp-q6 Documentation for advanced grammar support was added to the canonical-docs/snappy-docs repository. The syntax update pull request merged on January 24, 2018, fulfilling the request to document grammar-powered source keys.
qwen3.6-35b-a3b-mtp-q6 Documentation for snapcraft's advanced grammar was merged into the canonical-docs/snappy-docs repository. The syntax page was updated to cover grammar support for lists and strings, resolving the request.

Update history

No update history recorded yet.

Related issues

Issue Project State Summary Similarity
#5462 docs: migrate 'Snapcraft advanced grammar' snapcraft merged Merged documentation migration for the Snapcraft advanced grammar reference. Approved by two reviewers and passed CI checks before being squashed into the main branch.
78%
#5995 Documentation doesn't describe which keys can use advanced grammar snapcraft open Docs gap: advanced-grammar reference never lists which snapcraft.yaml keys support the syntax (only hinted via examples). Maintainer confirmed the omission and pointed to a separate feature request for broader key coverage; doc fix still pending.
73%