Update architectures documentation
Metadata
Current evaluation
Requested Snapcraft architectures documentation updates covering defaults, environment variables, CLI options, and cross-compilation. Contributors discussed details, but the request closed without implementation, indicating abandonment.
Suggested action: —
No scores available.
Issue body
### What needs to get done
The [architectures documentation](https://snapcraft.io/docs/architectures) needs to be improved, including:
- default behaviors (e.g. core22 builds for all architectures)
- description of architectural envvars
- description of cli options (`--target-arch`, `--build-for`)
- what happens in destructive mode (e.g. does the environment get cleaned?)
- validation rules and limitations
I would like to get ideas and feedback from @rpjday.
### Why it needs to get done
Architectures are complex and need thorough documentation.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b | — | — | Requested Snapcraft architectures documentation updates covering defaults, environment variables, CLI options, and cross-compilation. Contributors discussed details, but the request closed without implementation, indicating abandonment. | |
| qwen/qwen3.6-35b-a3b | — | — | Requested documentation updates for Snapcraft architectures. The ticket was closed without a documented resolution or merge, indicating the work was abandoned or deferred. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed without a documented resolution. Discussion covered documentation improvements and cross-compilation notes, but no pull request was merged. The request appears deferred or abandoned. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Requested documentation updates for Snapcraft architectures. A contributor began work, but the issue was closed without completion or merge, indicating it was abandoned. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Closed without implementation or a linked pull request. No documentation updates were completed, indicating the request was abandoned. |
Update history
No update history recorded yet.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1533713 Add metadata describing the architectures that a snap can be built for | snapcraft (launchpad) | closed | Closed and redirected to Launchpad. The request to add build architecture metadata to snapcraft.yaml was acknowledged but never implemented. The feature was abandoned. | |
| #1681 Design/document support for architecture selection during builds | snapcraft | closed | Closed after scope expanded beyond initial grammar changes. Proposal discussions and final documentation were moved to the Snapcraft forum, formally documenting the architecture selection feature for build.snapcraft.io. | |
| #4362 docs(architectures): reword how to section | snapcraft | merged | Merged a documentation update that reworded the architecture section to remove the term cross-compiling, clarifying snapcraft does not auto-cross-compile. Approved by two reviewers, passed CI, and merged. |