Skip to content

[docs-scanner] Contradictory WSL version requirements for Enhanced Container Isolation #24956

@docker-agent

Description

@docker-agent

File: content/manuals/enterprise/security/hardened-desktop/enhanced-container-isolation/_index.md and content/manuals/enterprise/security/hardened-desktop/enhanced-container-isolation/limitations.md

Issue

Two files in the same directory provide different WSL version requirements for Enhanced Container Isolation:

In _index.md:

If you are using WSL2 backend, ensure you're running WSL version 2.6 or later. This is required because ECI depends on a Linux kernel version of at least 6.3.0, and WSL 2.6+ includes kernel version 6.6.

In limitations.md:

Docker Desktop requires WSL 2 version 2.1.5 or later. Check your version with wsl --version and update with wsl --update if needed.

Why this matters

A reader trying to determine if their system meets the requirements for ECI will encounter conflicting information. The main overview page says 2.6+ is required, while the limitations page says 2.1.5+ is required. This is confusing and may lead users to either:

  • Unnecessarily upgrade when 2.1.5 is sufficient
  • Attempt to use ECI with 2.1.5 when 2.6 is actually required

Suggested fix

Determine the correct minimum WSL version requirement and use it consistently across both documents. If different versions are required for different levels of functionality, explain this clearly. For example:

  • If 2.1.5 is the minimum for Docker Desktop but 2.6 is required for ECI specifically, state this clearly in both places
  • If 2.6 is the actual requirement, update limitations.md to match
  • If 2.1.5 is sufficient, update _index.md to match

Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/generatedarea/desktopIssue affects a desktop edition of Docker. E.g docker for macarea/securitystatus/confirmedIssue triaged and confirmed as a real problem, ready to fix

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions