Skip to content

[docs-scanner] Version-specific availability notes may be stale #24185

@docker-agent

Description

@docker-agent

File: content/manuals/desktop/features/desktop-cli.md

Issue

The Commands table includes multiple version-specific availability notes that may become stale:

update - Manage Docker Desktop updates. Available for Mac only with Docker Desktop version 4.38, or all OSs with Docker Desktop version 4.39 and later.

kubernetes - List Kubernetes images used by Docker Desktop or restart the cluster. Available with Docker Desktop version 4.44 and later.

diagnose - Diagnose Docker Desktop and upload the diagnostics. Available with Docker Desktop 4.60 and later.

These version-specific notes create several problems:

  1. They become less relevant over time as users upgrade
  2. They don't indicate what happens on older versions (error message? command not found?)
  3. They clutter the table with historical information

Suggested fix

Consider one of these approaches:

  1. Remove version notes entirely - If these commands are now available in all supported versions of Docker Desktop, the version information is no longer useful.

  2. Move to a separate section - Create a "Version History" or "Availability" section at the bottom of the page for users who need to know when features were introduced.

  3. Use a minimum version approach - If Docker Desktop has a minimum supported version, only note features that require versions newer than that minimum.

The goal is to keep the main reference table focused on current functionality, not historical availability.


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