Skip to content

[docs-scanner] Stale framing: HyperKit deprecation described as future event #24557

@docker-agent

Description

@docker-agent

File: content/manuals/desktop/features/vmm.md

Issue

The HyperKit section describes deprecation as a future event:

HyperKit will be deprecated in a future release.

This framing goes stale as time passes. If HyperKit has been deprecated, the documentation should reflect that. If it hasn't been deprecated yet, the documentation should either:

  1. State when deprecation is planned (with a specific version or date), or
  2. Remove the forward-looking statement until deprecation actually occurs

Suggested fix

If HyperKit is already deprecated:

HyperKit is deprecated.

If HyperKit is not yet deprecated but deprecation is planned:

HyperKit is a legacy option and may be deprecated in a future release.

Or simply remove the deprecation notice until it actually happens, and keep only:

HyperKit is a legacy virtualization option, specifically for Intel-based Macs. Docker recommends switching to modern alternatives for better performance and to future-proof your setup.

Context

The note uses future tense ("will be deprecated") which is a form of stale framing prohibited by STYLE.md. Documentation should describe the current state, not future plans, unless those plans have specific timelines.


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