Confusing and contradictory information about paths resolving in extend
Mantenedores costumam responder em até 1 dia
Avaliação
- Dificuldade
- 2/5
- Tempo estimado
- 1-3 horas
- Facilidade para iniciantes
- 72/100
- Tipo de issue
- Documentação
- Clareza
- Razoavelmente clara
- Status de atividade
- Ativa
- Stack de tecnologia
- docker-compose
- Domínio
- documentation
Direção de pesquisa
Leia o bloco “Important” e a seção “Relative paths” na página vinculada do Docker Compose sobre extends e, em seguida, verifique qual comportamento está correto. Atualize as orientações conflitantes para que a página explique de forma consistente como os caminhos são resolvidos ao usar extends. A tarefa estará concluída quando os leitores puderem identificar quais caminhos são relativos ao arquivo Compose base e como os caminhos no serviço estendido são tratados.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Is this a docs issue?
- My issue is about the documentation content or website
Type of issue
Information is incorrect
Description
The information in the important block contradicts with what is described in the "Relative paths" section.
"Important" block says:
When you use multiple Compose files, you must make sure all paths in the files are relative to the base Compose file (i.e. the Compose file in your main-project folder). (...)
And the "Relative paths" section describes the behavior as follows:
When using extends with a file attribute which points to another folder, relative paths declared by the service being extended are converted so they still point to the same file when used by the extending service.
This is confusing and is not obvious which information is true.
Location
https://docs.docker.com/compose/how-tos/multiple-compose-files/extends/
Suggestion
Remove either the "important" block or "relative paths" section - leave only the proper information.
- Linguagem predominante
- Markdown
- Estrelas
- 4.7k
- Forks
- 8.5k
- Merge médio
- 2d 9h
- PRs com merge (30d)
- 126
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 75/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 85/100
Mantenedores costumam responder em até 1 dia
-
Debian installation pitfallTalvez já em andamento @Duo-ee assumiu há 2 dias. Abertastatus/triage
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 85/100
Mantenedores costumam responder em até 1 dia
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'Talvez já em andamento @dave123981 assumiu há 3 dias. Aberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
Mantenedores costumam responder em até 1 dia
-
status/triage
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
docker/docs#26484 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
Todas as issues de docker/docs
Issues semelhantes
-
documentation severity: low
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
luainkernel/lunatik#2231 ·
Mantenedores costumam responder em até 1 dia
-
赞~Aberta
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 72/100
DeanChensj/jiangshan-map#221 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 62/100
-
enhancement
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 82/100
Mantenedores costumam responder em até 1 dia
-
Weekly link check failedAberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 62/100