Skip to content

[docs-scanner] Confusing legacy builder note in Builds documentation #24453

@docker-agent

Description

@docker-agent

File: content/manuals/desktop/use-desktop/builds.md

Issue

The note about Windows container builds contains confusing time-relative language:

When building Windows container images using the docker build command, the legacy builder is used which does not populate the Builds view.

The phrase "the legacy builder is used" describes current behavior but frames it as temporary/legacy without explaining why this limitation exists or if it will change. This creates uncertainty for readers about whether this is expected behavior or a bug.

Suggested fix

Clarify the current state more directly:

"When building Windows container images, the docker build command uses a legacy builder that doesn't populate the Builds view. To use BuildKit and see builds in this view, either:"

This removes the passive "is used" construction and makes it clear this is current expected behavior, while still providing the workaround.


Found by nightly documentation freshness scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/generatedagent/skipTriaged; not actionable (STALE, UPSTREAM, INDETERMINATE, CLOSEABLE_FIXED)agent/triagedAgent has analyzed this issue; verdict in a comment

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions