Skip to content

[docs-scanner] Unclear recommendation against WSL 2 setup #24219

@docker-agent

Description

@docker-agent

File: content/manuals/desktop/features/networking/_index.md

Issue

The backend components table contains a recommendation that may confuse users:

| Windows (WSL 2) | WSL 2 | com.docker.backend.exe | WSL 2 kernel (no visibility from host) | Recommended only when WSL 2 integration is needed |

The note "Recommended only when WSL 2 integration is needed" is vague and potentially confusing. It doesn't explain:

  • What "WSL 2 integration" means in this context
  • Why this setup should be avoided otherwise
  • What the alternative is for Windows users

This is especially unclear because many Windows users may assume WSL 2 is the default or recommended setup for Docker Desktop on Windows, when this note suggests it should only be used in specific circumstances.

Suggested fix

Either:

  1. Clarify what "WSL 2 integration" means (e.g., "when you need to run Docker inside WSL 2 distributions")
  2. Explain the trade-off more clearly (e.g., "Use Hyper-V for better visibility; use WSL 2 only when you need to access Docker from WSL 2 distributions")
  3. Link to documentation that explains when to choose WSL 2 vs Hyper-V backend

This would help users make an informed decision about which backend to use.


Found by nightly documentation freshness scanner

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions