Skip to content

[docs-scanner] Time-relative version language in WSL best practices #24367

@docker-agent

Description

@docker-agent

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-data distribution; instead Docker Desktop creates and manages its own virtual hard disk (VHDX) for storage. (note, however, that Docker Desktop keeps using the docker-desktop-data distribution 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

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