[docs-scanner] Contradictory default values for REMOVEEXISTINGINSTALL property
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 75/100
- Issue 类型
- 文档
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- docker
调研方向
阅读 content/manuals/desktop/enterprise/enterprise-deployment/faq.md 和 content/manuals/desktop/enterprise/enterprise-deployment/msi-install-and-configure.md 中的 REMOVEEXISTINGINSTALL 条目，然后验证 MSI 实际的默认行为。更新这两份文档，使其报告相同的已验证值，并确保 FAQ 示例保持一致。
由索引模型根据 Issue 内容生成。
描述
Files:
content/manuals/desktop/enterprise/enterprise-deployment/faq.mdcontent/manuals/desktop/enterprise/enterprise-deployment/msi-install-and-configure.md
Issue
The two files provide contradictory information about the default value of the REMOVEEXISTINGINSTALL MSI property:
faq.md (line 51):
REMOVEEXISTINGINSTALLdefaults to0and is available with Docker Desktop version 4.30 and later.
msi-install-and-configure.md (line 218, configuration table):
| Property | Description | Default |
|---|---|---|
REMOVEEXISTINGINSTALL |
When set to 1, an existing all-users EXE installation is uninstalled before the MSI installs... | 1 |
Why this matters
Administrators need to know the default behavior when deploying Docker Desktop via MSI. If an existing EXE installation is present:
- If the default is
0, the installation will fail unless they explicitly setREMOVEEXISTINGINSTALL=1 - If the default is
1, the existing installation will be automatically removed
This contradiction makes it impossible to know what will happen during deployment without testing, which could lead to unexpected behavior in production rollouts.
Suggested fix
Verify the actual default value and update both documents to match. The FAQ's example command explicitly sets REMOVEEXISTINGINSTALL=1, which suggests the default might actually be 0 (otherwise the explicit setting would be unnecessary).
Found by nightly documentation quality scanner
- 主要语言
- Markdown
- 星标
- 4.7k
- 派生
- 8.5k
- 平均合并
- 1 天 21 小时
- 30 天内合并 PR
- 127
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
docker/docs 的其他 Issue
-
[docs-scanner] Container proxy table misleadingly presents nested properties as separate parameters可能已有人在做 @dave123981 于 2 天前认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
-
[docs-scanner] Conflicting WSL version requirements between ECI pages可能已有人在做 @dave123981 于 3 天前认领。 未关闭
难度 1/5 1-3 小时 新手友好度 90/100
维护者通常 1 天内回复
-
[docs-scanner] Ambiguous version qualifier for MSI all-users installation requirement可能重新可做 关联的 PR 已关闭且未合并。 未关闭
难度 1/5 1 小时以内 新手友好度 92/100
维护者通常 1 天内回复
-
[docs-scanner] Unclear relationship between sandbox:use PAT permission and granular account permissions可能已有人在做 @dave123981 于 6 天前认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
-
[docs-scanner] Sandboxes API tutorial mentions client.get() without showing how to use it可能已有人在做 @nielskaspers 于 6 天前认领。 未关闭
难度 1/5 1-3 小时 新手友好度 88/100
维护者通常 1 天内回复
相似的 Issue
-
changelog investigate
难度 2/5 1-3 小时 新手友好度 68/100
ramnes/notion-sdk-py#408 ·
-
triage
难度 2/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
enhancement priority:low ready-for-dev
难度 2/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 95/100
维护者通常 1 天内回复
-
bug
难度 1/5 1 小时以内 新手友好度 85/100
QuantConnect/Documentation#2758 ·
维护者通常 1 天内回复