-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
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:
- Clarify what "WSL 2 integration" means (e.g., "when you need to run Docker inside WSL 2 distributions")
- 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")
- 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