Skip to content

[docs-scanner] Multiple version-specific notes may be stale #24196

@docker-agent

Description

@docker-agent

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-data distribution; 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:

  1. They become less relevant over time as users upgrade to newer versions
  2. The phrase "version X and later" will eventually apply to all supported versions
  3. 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-data distribution. 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-data distribution.

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

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