docs: make tutorials architecture-agnostic
Metadata
Current evaluation
Makes tutorials architecture-agnostic by replacing hardcoded amd64 with dynamic dpkg-based detection. Approved, CI passing, reviewer comments addressed.
Suggested action: needs review
Reason: The PR has been approved by a reviewer (asanvaq) with all CI checks passing and zero unresolved comments. The author addressed all review feedback on July 16, 2026, and the documentation-only change is ready for maintainer merge. It fixes open issue rockcraft#1280.
Impact:
40
Quick Win:
34.0
Staleness:
10
Complexity:
15
Confidence:
85
Issue body
#### Summary
Several tutorials hardcoded `amd64` in the `platforms:` block and in the
resulting `.rock` filenames used by later commands. A reader on an arm64 host
packs a `..._arm64.rock` file, so the copy-paste `skopeo` import commands that
reference `..._amd64.rock` fail with a file-not-found error.
This applies the approach already used by the Flask tutorial across the
remaining affected tutorials.
#### Changes
Tutorials updated: **Hello World**, **Pack a Python package** (pyfiglet), and
**Bundle a Node.js app**. For each:
- `rockcraft.yaml`: commented-out extra architectures + a hint to check the
host arch with `dpkg --print-architecture`.
- `task.yaml`: hardcoded `..._amd64.rock` replaced with
`..._$(dpkg --print-architecture).rock`; `skopeo copy` reformatted to
multi-line.
- `.rst`: added a note after `rockcraft pack` clarifying the `.rock` filename
depends on name, version, and platform.
#### Testing
- `make docs-lint` — passes (0 errors/warnings, linkcheck clean)
- `make test-fast` — 620 passed, 1 skipped
The `task.yaml` files run in CI as Spread tests; the `dpkg` substitution keeps
them passing on any host architecture.
Fixes #1280
---
- [ x] I've followed the [contribution guidelines](https://github.com/canonical/rockcraft/blob/main/CONTRIBUTING.md).
- [ x] I've signed the [CLA](http://www.ubuntu.com/legal/contributors/).
- [ x] I've successfully run `make lint && make test-fast`.
- [x ] I've added or updated any relevant documentation.
- [ x] In documents I changed, I [added a meta description](https://canonical-starflow.readthedocs-hosted.com/how-to/add-a-page-meta-description/) if one was missing.
- [ ] I've updated the relevant release notes.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| qwen/qwen3.6-35b-a3b |
Impact:
40
Quick Win:
34.0
Staleness:
10
Complexity:
15
Confidence:
85
|
needs review | Makes tutorials architecture-agnostic by replacing hardcoded amd64 with dynamic dpkg-based detection. Approved, CI passing, reviewer comments addressed. | |
| qwen/qwen3.6-35b-a3b |
Impact:
40
Quick Win:
32.0
Staleness:
15
Complexity:
20
Confidence:
80
|
needs review | Makes tutorials architecture-agnostic by replacing hardcoded amd64 with dpkg --print-architecture. Reviewed, author addressed comments, most CI passing except docs-spread-tests. | |
| qwen/qwen3.6-35b-a3b |
Impact:
40
Quick Win:
34.0
Staleness:
5
Complexity:
15
Confidence:
90
|
needs review | Documentation update making tutorials architecture-agnostic by replacing hardcoded amd64 with dynamic architecture detection. Approved, CI passing, comments addressed. | |
| qwen3.6-35b-a3b-mtp-q6 |
Impact:
35
Quick Win:
29.75
Staleness:
25
Complexity:
15
Confidence:
75
|
needs review | Makes tutorials architecture-agnostic by replacing hardcoded amd64 with dynamic architecture detection. Approved by 1 reviewer, all comments addressed, CI passing. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
15
Confidence:
85
|
needs review | Updates tutorials to dynamically detect host architecture instead of hardcoding amd64, preventing copy-paste failures on arm64. Approved by one reviewer with requested changes implemented; awaiting minor network-related lint fix. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
10
Confidence:
85
|
needs review | Updates three tutorials to dynamically detect host architecture instead of hardcoding amd64, preventing copy-paste failures on arm64 systems. Implements reviewer feedback and passes local tests. Awaiting maintainer review to address a minor external network lint issue. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
15
Confidence:
90
|
needs review | Updates three tutorials to replace hardcoded amd64 architectures with dynamic detection, resolving copy-paste failures on arm64 hosts. PR is approved with recent author updates addressing reviewer feedback and pending minor CI fixes. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
10
Confidence:
90
|
needs review | Updates tutorials to dynamically detect host architecture instead of hardcoding amd64, preventing copy-paste failures on arm64. Approved by reviewer, feedback implemented, awaiting merge. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
15
Confidence:
90
|
needs review | Updates three tutorials to dynamically detect host architecture instead of hardcoding amd64, preventing copy-paste failures on arm64. Approved by one reviewer, CI mostly passes except a known unrelated docs-spread-test failure, awaiting final commit. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
10
Confidence:
90
|
needs review | Updates documentation tutorials to dynamically detect host architecture instead of hardcoding amd64. Approved by one reviewer, CI passing, and actively addressed with recent contributor updates. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
5
Complexity:
15
Confidence:
90
|
needs review | Updates tutorials to use dynamic architecture detection instead of hardcoded amd64, fixing arm64 copy-paste errors. Approved by one reviewer, all CI checks passing, and ready for final maintainer merge. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
0
Complexity:
10
Confidence:
90
|
needs review | Updates tutorials to dynamically detect host architecture instead of hardcoding amd64, fixing copy-paste failures on arm64 hosts. Tests pass; awaiting maintainer review/rebase. |
Update history
| Date | Change |
|---|---|
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated | |
| updated |
Related work
-
Related To:
rockcraft#1280
(confidence 95%)
PR body explicitly states 'Fixes #1280' — the issue this PR resolves, which describes tutorials hardcoding amd64 and breaking for arm64 users.
Related issues
No related issues found above the similarity threshold.