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