Docs: Your First Snap Snap Icon section refers to non-existent directory
Metadata
Current evaluation
⚠️ This summary may be outdated — the issue content or evaluation prompts have changed since this evaluation was made.
Closed documentation issue noting a missing directory reference in the Your First Snap walkthrough. The inconsistency was resolved by updating the guide to explicitly include the missing setup step.
Suggested action: —
No scores available.
Issue body
In the Your First Snap walkthrough, the Snap Icon section towards the end refers to setup/gui/ as the place to put your icon.[svg|png] file.
However, nowhere in the previous steps did we create a "setup" directory. 'snapcraft init' does not create this, and none of the other steps create this either.
It's an inconsistency and a missing step in a walkthrough meant for new users, so I think every single step should be called out explicitly.
IN this case, I simply created the dir:
$ mkdir -p setup/gui
and copied icon.svg into the dir.
The snap seems to have built fine though!
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Closed documentation issue noting a missing directory reference in the Your First Snap walkthrough. The inconsistency was resolved by updating the guide to explicitly include the missing setup step. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed. Documentation inconsistency regarding the missing setup/gui/ directory was reported. No explicit fix, merge, or resolution was recorded. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Closed without documented resolution. The documentation inconsistency regarding the missing setup/gui directory in the Your First Snap walkthrough was not addressed. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1609564 Docs: Your First Snap seems broken and confusing in the Extending the Metadata section | snapcraft (launchpad) | closed | Closed. Documentation was updated to resolve the reported inconsistencies in the Extending the Metadata section, aligning the example with previous steps. | |
| #1575047 "Your first snap" implies that a Snappy device is required | snapcraft (launchpad) | closed | Fixed. Documentation updated to clarify local snap installation and mention Launchpad builders. The issue was closed after the guide was revised to remove the misleading device requirement. | |
| #1578231 Your first snap: Use of icon in snapcraft.yaml is deprecated | snapcraft (launchpad) | closed | Documentation updated to replace the deprecated icon field in snapcraft.yaml with the setup/gui directory method. Tutorial corrected and verified. Issue closed. |