[docs-scanner] Conflicting WSL version requirements between ECI pages
Mantenedores costumam responder em até 1 dia
Avaliação
- Dificuldade
- 1/5
- Tempo estimado
- 1-3 horas
- Facilidade para iniciantes
- 90/100
- Tipo de issue
- Documentação
- Clareza
- Claramente especificada
- Status de atividade
- Ativa
- Stack de tecnologia
- docker
- Domínio
- documentation
Direção de pesquisa
Leia as duas páginas mencionadas: content/manuals/desktop/enterprise/hardened-desktop/enhanced-container-isolation/_index.md e limitations.md. Compare as declarações sobre a versão do WSL e esclareça de forma consistente que o Docker Desktop geralmente oferece suporte ao WSL 2.1.5+, enquanto o ECI requer a versão 2.6+. O trabalho estará concluído quando os leitores puderem distinguir o requisito geral do requisito específico do ECI em ambas as páginas.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
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
- Linguagem predominante
- Markdown
- Estrelas
- 4.7k
- Forks
- 8.5k
- Merge médio
- 2d 2h
- PRs com merge (30d)
- 124
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de docker/docs
-
status/triage
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
docker/docs#26285 · 2 comentários ·
Mantenedores costumam responder em até 1 dia
-
[docs-scanner] Container proxy table misleadingly presents nested properties as separate parametersTalvez já em andamento @dave123981 assumiu há 4 dias. Aberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
Mantenedores costumam responder em até 1 dia
-
[docs-scanner] Ambiguous version qualifier for MSI all-users installation requirementTalvez livre de novo Um pull request para esta issue foi fechado sem ser mesclado. Aberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 92/100
Mantenedores costumam responder em até 1 dia
-
[docs-scanner] Unclear relationship between sandbox:use PAT permission and granular account permissionsTalvez já em andamento @dave123981 assumiu há 8 dias. Aberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
docker/docs#26225 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
Todas as issues de docker/docs
Issues semelhantes
-
CONTRIBUTING.md: say how ticketless bug fixes and feature PRs are handledTalvez já em andamento @khuisman assumiu hoje. Abertav0.9.2
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 84/100
khuisman/mcp-gee-sweet#941 ·
Mantenedores costumam responder em até 1 dia
-
#242 leftovers: dated narrative and shas in the social-features test planTalvez já em andamento Um pull request vinculado a esta issue está aberto ou já foi mesclado. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
EchoTools/nevr-runtime#264 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 70/100
Automattic/data-liberation-agent#685 ·
Mantenedores costumam responder em até 1 dia
-
bug
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 77/100
Crosstalk-Solutions/project-nomad#1427 ·
Mantenedores costumam responder em até 2 dias
-
automated issue report
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 68/100