Docs: Your First Snap seems broken and confusing in the Extending the Metadata section
Metadata
Current evaluation
⚠️ This summary may be outdated — the issue content or evaluation prompts have changed since this evaluation was made.
Closed. Documentation was updated to resolve the reported inconsistencies in the Extending the Metadata section, aligning the example with previous steps.
Suggested action: —
No scores available.
Issue body
On the Your First Snap walk-through:
https://developer.ubuntu.com/en/snappy/build-apps/your-first-snap/
We get to the "Filesets" section which, when complete gives us a snapcraft.yaml that looks like this:
parts:
cam:
plugin: go
source: git://github.com/mikix/golang-static-http
stage-packages:
- fswebcam
filesets:
fswebcam:
- usr/bin/fswebcam
- lib
- usr/lib
go-server:
- bin/golang-*
snap:
- $fswebcam
- $go-server
glue:
plugin: copy
files:
webcam-webui: bin/webcam-webui
Once that section is complete we move next to the "Extending the Metadata" section. This section presents examples that do not flow with the previous steps and are confusing.
First, the intro for this section says:
The templated values when snapcraft init was run did not hold any parts which we've filled along the way. It also did not define any apps which we will be adding now
Edit snapcraft.yaml once more and add the services and binaries entry, your resulting snapcraft.yaml should look very similar to:
The example snapcraft.yaml looks like this:
name: webcam-webui
version: 1
summary: Webcam web UI
description: Exposes your webcam over a web UI
confinement: strict
apps:
webcam-webui:
command: bin/webcam-webui
daemon: simple
parts:
golang-static-http:
plugin: go
source: git://github.com/mikix/golang-static-http
stage-packages:
- fswebcam
glue:
plugin: copy
files:
webcam-webui: bin/webcam-webui
We have an apps section but it does not define any "binaries" or "services" entries. It DOES define a "command" and "daemon" entry, I presume "binaries" == "command" and "services" == "daemon"??
And the parts section is now missing all the stuff we added in the last two steps, making it seem as though we should have deleted the "filesets" and "snap" section of snapcraft.yaml/parts/
Additionally, in parts, the "cam" section we've been using in this example has changed names to "golang-static-http"
The walkthrough is pretty informative and well written, but there are some inconsistencies that can be (are) confusing when stepping through the example first snap.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Closed. Documentation was updated to resolve the reported inconsistencies in the Extending the Metadata section, aligning the example with previous steps. | |
| qwen/qwen3.6-35b-a3b | — | — | Documentation inconsistencies in the Your First Snap tutorial were closed without resolution. With zero comments, the report appears abandoned or superseded by updated guides. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Reported documentation inconsistencies in the Your First Snap guide. Closed without resolution, effectively abandoned. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1609568 Docs: Your First Snap Snap Icon section refers to non-existent directory | snapcraft (launchpad) | closed | 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. |