-
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 document contains time-relative language that frames features as "new" based on version numbers. This violates STYLE.md's prohibition on time-relative language, as these statements will become outdated and confusing to readers who don't know what the "current" version is.
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. (note, however, that Docker Desktop keeps using thedocker-desktop-datadistribution if it was already created by an earlier version of the software).
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.
Suggested fix
Rewrite to describe the current behavior without framing it as a transition or recent change:
- Remove "version 4.30 and later" and "Starting from version 4.34 and later"
- State what Docker Desktop does now, without reference to when it changed
- If version-specific behavior is important for troubleshooting, move it to a note about older versions
Example revision:
"Docker Desktop creates and manages its own virtual hard disk (VHDX) for storage. If you upgraded from an earlier version that created a docker-desktop-data distribution, Docker Desktop continues using that distribution."
Found by nightly documentation freshness scanner