-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
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-desktopanddocker-desktop-data.docker-desktopis used to run the Docker enginedockerd, whiledocker-desktop-datastores containers and images. Neither can be used for general development.With fresh installations of Docker Desktop 4.30 and later,
docker-desktop-datais no longer created. Instead, Docker Desktop creates and manages its own virtual hard disk for storage. Thedocker-desktopdistribution is still created and used to run the Docker engine.Note that Docker Desktop version 4.30 and later keeps using the
docker-desktop-datadistribution 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:
- The phrase "4.30 and earlier" becomes increasingly irrelevant as users upgrade
- The detailed explanation of legacy behavior clutters the current documentation
- 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-desktopto 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-datadistribution. 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