[docs-scanner] Conflicting WSL version requirements between ECI pages
メンテナーはふだん 1 日以内に返信
評価
- 難易度
- 1/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 90/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- docker
調査の方向性
次の2つの指定されたページを読んでください: 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
- 平均マージ
- 1日 21時間
- マージ済み PR(30日)
- 127
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
docker/docs のほかの issue
-
[docs-scanner] Container proxy table misleadingly presents nested properties as separate parameters対応中かも @dave123981 が 2 日前に担当しました。 オープン
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
メンテナーはふだん 1 日以内に返信
-
[docs-scanner] Ambiguous version qualifier for MSI all-users installation requirement再び着手できるかも このイシューのプルリクエストはマージされずにクローズされました。 オープン
難易度 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
docker/docs#26225 · コメント 1 件 ·
メンテナーはふだん 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
github/docs#46222 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
bug
難易度 1/5 1〜3時間 初心者へのやさしさ 72/100
peteonrails/voxtype#844 ·
メンテナーはふだん 1 日以内に返信
-
enhancement priority:low ready-for-dev
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
メンテナーはふだん 1 日以内に返信
-
Add a mail symbolオープンenhancement good first issue
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100