-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
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 buildcommand, 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