Skip to content

[docs-scanner] Stale version-specific framing in WSL distribution note #24188

@docker-agent

Description

@docker-agent

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

Issue

The note about Docker Desktop's internal distributions uses version-specific framing that will become stale:

With Docker Desktop version 4.30 and earlier, Docker Desktop installed two special-purpose internal Linux distributions docker-desktop and docker-desktop-data. docker-desktop is used to run the Docker engine dockerd, while docker-desktop-data stores containers and images. Neither can be used for general development.

With fresh installations of Docker Desktop 4.30 and later, docker-desktop-data is no longer created. Instead, Docker Desktop creates and manages its own virtual hard disk for storage. The docker-desktop distribution is still created and used to run the Docker engine.

Note that Docker Desktop version 4.30 and later keeps using the docker-desktop-data distribution if it was already created by an earlier version of Docker Desktop and has not been freshly installed or factory reset.

This creates several problems:

  1. The phrase "4.30 and earlier" becomes increasingly irrelevant as users upgrade
  2. The detailed explanation of legacy behavior clutters the current documentation
  3. Users on current versions don't need to know about historical implementation details

Suggested fix

Simplify to focus on current behavior:

Docker Desktop creates a special-purpose internal Linux distribution docker-desktop to run the Docker engine. This distribution cannot be used for general development.

Note: Installations upgraded from Docker Desktop 4.29 or earlier may also have a docker-desktop-data distribution. Fresh installations of Docker Desktop 4.30 and later manage storage using a virtual hard disk instead.

This preserves the essential information for users who might see docker-desktop-data while removing the version-specific framing that will become stale.


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