← Back to issue list

Document using Snapcraft under WSL

View original Github issue

Metadata

Project
snapcraft
Number
#4965
Type
issue
State
open
Author
lengau
Labels
Status: Triaged Type: Documentation
Created
Updated
Closed
—

Current evaluation

Docs request: split How-to > Set up Snapcraft into Linux and WSL sections covering systemd, snapd, reboot and install steps. Triaged (CRAFT-3231); mr-cal wants a WSL smoketest before endorsing. Restructure not yet done.

Suggested action: keep open

Reason: The issue is labeled 'Status: Triaged' and 'Type: Documentation' by maintainer lengau with explicit requirements, and the requested restructure is verifiably still undone: docs/how-to/set-up-snapcraft.rst still has 'Install the main components' with a Linux/macOS/Windows tab-set rather than the requested Linux plus 'Windows Subsystem for Linux' sections. It remains relevant because Snapcraft 9 release notes (docs/release-notes/snapcraft-9-0.rst) explicitly direct Windows users to WSL 'as described in how-to-set-up-snapcraft', yet that page only says 'install WSL2 ... then snap install snapcraft --classic' with no systemd/snapd setup. However mr-cal's comment ('I'd like to have a smoketest with WSL before we officially endorse it with documentation') plus the issue's own caveat 'As of 2024 these steps were needed' mean the documented procedure must be re-verified before writing, lowering actionability; no WSL CI job exists (all workflows run on ubuntu-* or self-hosted Linux runners).

Evaluated by: mr-cal-bot

Impact: 38 Quick Win: 13 Complexity: 42 Confidence: 80 Actionability: 58

Issue body

## Situation Snapcraft is supported on WSL, but there's no guidance for setting up the environment to create and test snaps. ## Requirements In **How-to** > **Set up Snapcraft**: - Move the existing _Install the main components_ section into a new _Linux_ section. - Add a new _Windows Subsystem for Linux_ section below the _Linux_ section, and cover the special procedures. As of 2024 these steps were needed for WSL: 1. Enable systemd in WSL 2. Enable snapd in WSL 3. Reboot VM 4. Install Snapcraft

Evaluation history

Date Model Scores Action Summary
stealth/space-bunny-alpha
Impact: 38
Quick Win: 13
Complexity: 42
Confidence: 80
Actionability: 58
keep open Docs request: split How-to > Set up Snapcraft into Linux and WSL sections covering systemd, snapd, reboot and install steps. Triaged (CRAFT-3231); mr-cal wants a WSL smoketest before endorsing. Restructure not yet done.
qwen/qwen3.6-35b-a3b
Impact: 30
Quick Win: 17
Complexity: 20
Confidence: 75
Actionability: 70
keep open Documentation issue requesting WSL setup guidance in the How-to section, currently triaged and awaiting smoketest before official endorsement.
qwen/qwen3.8-27b
Impact: 45
Quick Win: 32
Staleness: 45
Complexity: 30
Confidence: 78
Support Request: 10
keep open Docs request to add detailed WSL setup steps (enable systemd, snapd, reboot) to the Snapcraft setup guide. Triaged; maintainer wants a WSL smoketest before endorsing. Current docs have a basic WSL tab but lack the special procedures.
qwen/qwen3.6-35b-a3b
Staleness: 65
Complexity: 10
Confidence: 80
Support Request: 0
keep open Documentation request to add WSL setup instructions for Snapcraft. Triaged and acknowledged by maintainers, but currently blocked pending a WSL smoketest before official endorsement.
qwen3.6-35b-a3b-mtp-q6
Staleness: 60
Complexity: 20
Confidence: 85
Support Request: 0
keep open Documentation gap for setting up Snapcraft on WSL. Triaged and acknowledged by maintainers, but pending WSL smoketests before official endorsement.

Update history

No update history recorded yet.

Related work

  • Related To: charmcraft#1811 (confidence 90%)

    Exact mirror request 'Document using Charmcraft under WSL', also open and untriaged; shared WSL documentation work could be coordinated.

Related issues

Issue Project State Summary Similarity
#1811 Document using Charmcraft under WSL charmcraft open Documentation request to add a how-to for running Charmcraft on Windows via WSL (enable systemd, snapd, reboot, install snapcraft). No labels or comments; still open.
77%