[docs-scanner] Conflicting WSL version requirements between ECI pages
维护者通常 1 天内回复
评估
- 难度
- 1/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 90/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- docker
调研方向
阅读提到的两个页面：content/manuals/desktop/enterprise/hardened-desktop/enhanced-container-isolation/_index.md 和 limitations.md。比较其中关于 WSL 版本的表述，并始终明确 Docker Desktop 通常支持 WSL 2.1.5+，而 ECI 需要 2.6+。当读者能够在两个页面上区分一般要求和 ECI 特定要求时，即表示完成。
由索引模型根据 Issue 内容生成。
描述
Files:
content/manuals/desktop/enterprise/hardened-desktop/enhanced-container-isolation/_index.mdcontent/manuals/desktop/enterprise/hardened-desktop/enhanced-container-isolation/limitations.md
Issue
The two pages provide different context about WSL version requirements, creating potential confusion about what users actually need:
In _index.md:
If you are using WSL2 backend, ensure you're running WSL version 2.6 or later. This is required because ECI depends on a Linux kernel version of at least 6.3.0, and WSL 2.6+ includes kernel version 6.6.
In limitations.md:
Docker Desktop requires WSL 2 version 2.1.5 or later. ECI on the WSL 2 backend requires WSL version 2.6 or later because ECI depends on a Linux kernel version of at least 6.3.0.
Why this matters
A reader trying to understand WSL requirements encounters two different minimum versions:
- 2.1.5+ for Docker Desktop generally
- 2.6+ for ECI specifically
While technically both statements may be accurate (Docker Desktop works with 2.1.5+, but ECI needs 2.6+), the _index.md page doesn't mention the 2.1.5 baseline at all, which could lead readers to think 2.6 is required for Docker Desktop itself, not just for ECI.
Additionally, the _index.md presents this as a simple prerequisite without explaining that Docker Desktop can run without ECI on older WSL versions. This framing could confuse users who have WSL 2.1.5-2.5 and wonder if they can use Docker Desktop at all.
Suggested fix
Clarify the relationship between these requirements consistently across both pages:
- In _index.md, acknowledge that Docker Desktop works with WSL 2.1.5+, but ECI specifically requires 2.6+
- In limitations.md, ensure the note clearly distinguishes between general Docker Desktop requirements and ECI-specific requirements
- Consider adding a note in _index.md that users with WSL 2.1.5-2.5 can use Docker Desktop but cannot enable ECI
Example for _index.md:
If you are using the WSL 2 backend, Enhanced Container Isolation requires WSL version 2.6 or later (Docker Desktop itself works with WSL 2.1.5+). This is required because ECI depends on a Linux kernel version of at least 6.3.0, and WSL 2.6+ includes kernel version 6.6.
Found by nightly documentation quality scanner
- 主要语言
- Markdown
- 星标
- 4.7k
- 派生
- 8.5k
- 平均合并
- 2 天 2 小时
- 30 天内合并 PR
- 124
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
docker/docs 的其他 Issue
-
status/triage
难度 2/5 1-3 小时 新手友好度 70/100
维护者通常 1 天内回复
-
[docs-scanner] Container proxy table misleadingly presents nested properties as separate parameters可能已有人在做 @dave123981 于 4 天前认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 75/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 于 8 天前认领。 未关闭
难度 1/5 1 小时以内 新手友好度 88/100
维护者通常 1 天内回复
相似的 Issue
-
难度 1/5 1-3 小时 新手友好度 75/100
维护者通常 1 天内回复
-
License examples/ as MIT可能已有人在做 @PGrayCS 今天认领。 未关闭documentation enhancement example good first issue
难度 2/5 1-3 小时 新手友好度 84/100
speedyk-005/yasbd-lib#383 ·
维护者通常 1 天内回复
-
area:manual bug topic:i18n
难度 2/5 1-3 小时 新手友好度 78/100
godotengine/godot-docs#12435 ·
维护者通常 3 天内回复
-
documentation good first issue
难度 2/5 1-3 小时 新手友好度 78/100
Orbit-xyz/orbit-docs#11 ·
-
难度 1/5 1 小时以内 新手友好度 76/100
ZhengPeng7/BiRefNet#324 · 1 条评论 ·