docs: core20->core22 migration guide should mention removing `passthrough`
Metadata
Current evaluation
Documentation updated by merged canonical/snapcraft#6124 (commit 5bbc654e3), telling core22 users to remove passthrough and move hook environment data.
Resolution: closed resolved
Reason: Merged PR canonical/snapcraft#6124 resolved the request in commit 5bbc654e3. The migration guide now tells users to remove passthrough from public snaps and move environment data to hooks.environment.
Evaluated by: mr-cal-bot
No scores available.
Issue body
### Check existing issues
- [x] I've verified that this request isn't described by any existing issues.
### Request
The `passthrough` key was historically used for rapid development between snapcraft and snapd. Experimental data could be placed in `passthrough` and consumed by snapd, without requiring snapcraft to update its schema.
For core22 and higher, this key is flagged by review tools when uploading snaps to the store ([schema](https://git.launchpad.net/review-tools/tree/reviewtools/schemas/snap.json)). The [migration guide](https://documentation.ubuntu.com/snapcraft/stable/how-to/change-bases/change-from-core20-to-core22/) should inform users to not use it.
It should tell users to remove the `passthrough` key for production snaps. For example:
```yaml
hooks:
passthrough:
environment:
FOO: BAR
```
should become
```yaml
hooks:
environment:
FOO: BAR
```
A subsequent improvement would add a pre-lint rule for this.
### The problem it solves
To improve the docs.
source: https://chat.canonical.com/canonical/pl/6y69jfbhy7rczpj9xotbjjatdy
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Documentation updated by merged canonical/snapcraft#6124 (commit 5bbc654e3), telling core22 users to remove passthrough and move hook environment data. | |
| stealth/space-bunny-alpha | — | closed resolved | Documentation now tells core22 users to remove `passthrough` from public snaps and move hook environment data; merged in canonical/snapcraft#6124 (5bbc654e3). | |
| stealth/space-bunny-alpha | — | closed resolved | Documentation was updated by merged PR canonical/snapcraft#6124 (5bbc654e3), advising core22 users to remove passthrough and move hook environment data outside it. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged snapcraft#6124 (5bbc654e3), updating the core20-to-core22 migration guide to remove passthrough and place hook environment data directly under hooks. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed and assigned to a contributor for the requested documentation update. The core20 to core22 migration guide will be updated to warn against using the passthrough key for production snaps and provide the correct replacement structure. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed and assigned to a contributor to update the core20-to-core22 migration guide. Documentation will explicitly warn against using the passthrough key for production snaps and show the correct replacement structure. | |
| qwen/qwen3.6-35b-a3b | — | — | The documentation update request regarding the deprecated passthrough key was assigned to a contributor and closed, pending implementation via a separate pull request. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Closed and resolved via documentation update. A contributor volunteered to update the core20 to core22 migration guide, instructing users to remove the deprecated passthrough key for production snaps. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
canonical/snapcraft#6124
(confidence 100%)
Merged documentation PR implementing the requested migration-guide update.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #6124 docs: mention removing passthrough in core20 to core22 migration | snapcraft | merged | Merged PR #6124 (5bbc654e3) updated the core20-to-core22 migration guide to require removing passthrough for public snaps and moving hook environment data. | |
| #5405 docs: migrate 'migrate from core20 to core22' | snapcraft | merged | Merged the core20-to-core22 migration guide into main in commit c01e6a29f, documenting lifecycle command, grammar, architecture, environment-variable, and verification changes. |