Confusing and contradictory information about paths resolving in extend
维护者通常 1 天内回复
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 72/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- docker-compose
调研方向
阅读链接的 Docker Compose extends 页面中的“Important”区块和“Relative paths”部分，然后确认哪种行为是正确的。更新相互矛盾的说明，使页面始终一致地解释使用 extends 时路径如何解析。完成标准是，读者能够判断哪些路径相对于基础 Compose 文件，以及扩展服务中的路径如何处理。
由索引模型根据 Issue 内容生成。
描述
Is this a docs issue?
- My issue is about the documentation content or website
Type of issue
Information is incorrect
Description
The information in the important block contradicts with what is described in the "Relative paths" section.
"Important" block says:
When you use multiple Compose files, you must make sure all paths in the files are relative to the base Compose file (i.e. the Compose file in your main-project folder). (...)
And the "Relative paths" section describes the behavior as follows:
When using extends with a file attribute which points to another folder, relative paths declared by the service being extended are converted so they still point to the same file when used by the extending service.
This is confusing and is not obvious which information is true.
Location
https://docs.docker.com/compose/how-tos/multiple-compose-files/extends/
Suggestion
Remove either the "important" block or "relative paths" section - leave only the proper information.
- 主要语言
- Markdown
- 星标
- 4.7k
- 派生
- 8.5k
- 平均合并
- 2 天 9 小时
- 30 天内合并 PR
- 126
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
docker/docs 的其他 Issue
-
FAQ: Docker Desktop Kubernetes stuck on "Starting" behind a corporate proxy可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭status/triage
难度 2/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 85/100
维护者通常 1 天内回复
-
Debian installation pitfall可能已有人在做 @Duo-ee 于 2 天前认领。 未关闭status/triage
难度 1/5 1 小时以内 新手友好度 85/100
维护者通常 1 天内回复
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'可能已有人在做 @dave123981 于 3 天前认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
-
status/triage
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
相似的 Issue
-
neutral:fix
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
enhancement
难度 1/5 1-3 小时 新手友好度 68/100
-
难度 2/5 1-3 小时 新手友好度 78/100
wazuh/wazuh-documentation#10611 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
-
documentation
难度 1/5 1 小时以内 新手友好度 66/100
unicef/adt-studio#1059 ·
维护者通常 3 天内回复