Skip to content

[docs-scanner] Time-relative language in Bake Compose file documentation #24310

@docker-agent

Description

@docker-agent

File: content/manuals/build/bake/compose-file.md

Issue

The documentation contains time-relative language that suggests incomplete implementation:

The compose format has some limitations compared to the HCL format:

  • Specifying variables or global scope attributes is not yet supported

The phrase "is not yet supported" implies future work and creates uncertainty about whether this is a temporary limitation or a permanent design decision. This type of language goes stale as readers won't know if "not yet" means "coming soon" or "not planned."

Suggested fix

Remove the time-relative qualifier and state the current limitation directly:

"- Specifying variables or global scope attributes is not supported"

If there are plans to add this feature, add a note linking to the relevant issue or roadmap. If it's not planned, state it as a current limitation without temporal qualifiers.


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