Skip to content

Verify the Windows/WSL2 guide on a real machine #72

Description

@burakgon

Why: We ship a Windows/WSL2 guide (docs/windows-wsl.md) written from documented WSL behavior — but the maintainers develop on macOS/Linux, so it has never been executed end-to-end on a real Windows machine.

The task: on real Windows 10/11:

  1. Follow docs/windows-wsl.md top to bottom (fresh Ubuntu WSL if possible).
  2. Note every step that didn't match reality — wording, missing packages, systemd/lingering behavior, localhost forwarding, tunnel from WSL, phone connection.
  3. Report findings here (screenshots welcome) — or better, send a PR fixing the guide.

Acceptance criteria: the guide's "community-verified wanted" banner can be replaced with "verified on Windows 11 (build …, date)" and any incorrect steps are fixed.

No coding required — this is a great first contribution if you have Windows + 30 minutes.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentationgood first issueGood for newcomershelp wantedExtra attention is neededneeds-hardwareNeeds a specific OS/device to verify

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions