[docs-scanner] Ambiguous version qualifier for MSI all-users installation requirement
维护者通常 1 天内回复
还没有人认领这个 Issue。
- #26245 来自 @nielskaspers —— 已关闭，未合并
评估
- 难度
- 1/5
- 预计耗时
- 1 小时以内
- 新手友好度
- 92/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- docker, markdown
调研方向
先从 content/manuals/desktop/enterprise/enterprise-deployment/msi-install-and-configure.md 第 22 行附近开始，然后对照 faq.md 第 70-82 行中的版本详细信息。更新含义不明确的版本表述，使 MSI 功能和版本 4.92 的错误处理变更保持一致，并确认最终文本不再暗示早先就支持按用户使用。
由索引模型根据 Issue 内容生成。
描述
File: content/manuals/desktop/enterprise/enterprise-deployment/msi-install-and-configure.md
Issue
Line 22 contains an ambiguous version qualifier that contradicts information in the FAQ:
The MSI installer only supports all-users installations (version 4.92 and later).
This parenthetical "(version 4.92 and later)" suggests that the all-users-only restriction was introduced in version 4.92, implying the MSI may have supported per-user installations in earlier versions.
However, the FAQ (faq.md lines 70-82) makes it clear that:
- The MSI has never supported per-user installations
- Version 4.92 only introduced an explicit error message when
MSIINSTALLPERUSERis passed - Versions 4.91 and earlier accepted the flag but produced broken installations
Why this matters
Readers comparing these two pages will be confused about whether:
- The MSI ever supported per-user installations (it didn't)
- What changed in version 4.92 (only the error handling, not the capability)
An administrator reading the main installation page might incorrectly conclude that per-user MSI installations were possible before 4.92.
Suggested fix
Remove the version qualifier or clarify what changed in 4.92:
Option 1 (simplest):
The MSI installer only supports all-users installations. If you need a per-user installation, use the EXE installer.
Option 2 (if version context is important):
The MSI installer only supports all-users installations. (Version 4.92 and later explicitly reject per-user installation attempts; earlier versions accepted the flag but produced installations that couldn't be upgraded.)
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 天内回复
-
难度 2/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
[docs-scanner] Unclear relationship between sandbox:use PAT permission and granular account permissions可能已有人在做 @dave123981 于 5 天前认领。 未关闭
难度 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
-
难度 2/5 1-3 小时 新手友好度 66/100
MicrosoftLearning/PL-400_Microsoft-Power-Platform-Developer#231 ·
-
docs good first issue
难度 2/5 1-3 小时 新手友好度 78/100
VenetoStato/giorgio#6 ·
-
specification
难度 1/5 1 小时以内 新手友好度 85/100
WICG/webmonetization#754 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
linagora/twake-on-matrix#3446 ·
维护者通常 3 天内回复
-
feature request
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 2 天内回复