← Back to issue list

Update architectures documentation

View original Github issue

Metadata

Project
snapcraft
Number
#4336
Type
issue
State
closed
Author
mr-cal
Labels
—
Created
Updated
Closed

Current evaluation

Closed without a linked resolution after documentation-planning comments. Later platform documentation was rewritten in canonical/snapcraft#6069 (commit 88b36a7d6).

Resolution: closed stale

Reason: No closing comment, PR, or commit explicitly resolves #4336, and the available history shows no recorded follow-up after the 2023 discussion. Platform documentation was later rewritten in #6069, but there is no evidence that PR was created to close this issue.

Evaluated by: mr-cal-bot

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
stealth/space-bunny-alpha — closed stale Closed without a linked resolution after documentation-planning comments. Later platform documentation was rewritten in canonical/snapcraft#6069 (commit 88b36a7d6).
stealth/space-bunny-alpha — closed resolved Architecture docs were expanded in canonical/snapcraft#4349 (commit c8e9b2e42), with how-to, reference, and explanation material; #4362 and #4436 later refined wording and core22 syntax.
stealth/space-bunny-alpha — closed stale Architecture documentation proposal was closed after 2023 planning comments, with no identified resolving PR, commit, or recorded follow-up.
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.

Update history

No update history recorded yet.

Related work

  • Likely Fixed By: canonical/snapcraft#6069 (confidence 78%)

    Rewrote the platform documentation, including build-for options, environment variables, and supported architectures.

  • Related To: canonical/snapcraft#6092 (confidence 60%)

    Added platform naming rules as a follow-up to the platform documentation rewrite.

  • Related To: canonical/snapcraft#6351 (confidence 55%)

    Applied additional documentation feedback after the platform documentation rewrite.

Related issues

Issue Project State Summary Similarity
#4362 docs(architectures): reword how to section snapcraft merged Merged #4362 (commit c6a4cf7a1), clarifying architecture-build docs and removing cross-compiling wording because Snapcraft does not automatically cross-compile.
71%