-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
File: content/manuals/desktop/features/wsl/best-practices.md
Issue
The page contains multiple version-specific notes that frame features in terms of when they were introduced:
Installations of Docker Desktop version 4.30 and later no longer rely on the
docker-desktop-datadistribution; instead Docker Desktop creates and manages its own virtual hard disk (VHDX) for storage.
Starting from version 4.34 and later, Docker Desktop automatically manages the size of the managed VHDX and returns unused space to the operating system.
These version-specific notes create several problems:
- They become less relevant over time as users upgrade to newer versions
- The phrase "version X and later" will eventually apply to all supported versions
- They clutter best practices with historical context rather than current guidance
According to STYLE.md: "Avoid time-relative language: 'currently', 'recently', 'coming soon', 'new in X.Y' — these go stale silently."
Suggested fix
Rewrite to focus on current behavior without version-specific framing:
Docker Desktop creates and manages its own virtual hard disk (VHDX) for storage, rather than using the
docker-desktop-datadistribution. The VHDX size is automatically managed, returning unused space to the operating system.Note: Installations upgraded from Docker Desktop 4.29 or earlier may still use the
docker-desktop-datadistribution.
This preserves essential information for users who might encounter legacy behavior while removing version-specific framing that will become stale.
Found by nightly documentation freshness scanner