Confusing and contradictory information about paths resolving in extend
Les mainteneurs répondent en général sous 1 jour
Évaluation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Accessibilité débutants
- 72/100
- Type d'issue
- Documentation
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- docker-compose
- Domaine
- documentation
Piste de recherche
Lisez le bloc « Important » et la section « Relative paths » sur la page Docker Compose liée consacrée à extends, puis vérifiez quel comportement est correct. Mettez à jour les indications contradictoires afin que la page explique de manière cohérente comment les chemins sont résolus lors de l’utilisation de extends. Le travail est terminé lorsque les lecteurs peuvent déterminer quels chemins sont relatifs au fichier Compose de base et comment sont traités les chemins du service étendu.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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.
- Langage dominant
- Markdown
- Étoiles
- 4.7k
- Forks
- 8.5k
- Merge moyen
- 2 j 9 h
- PR mergées (30 j)
- 136
Préparer son environnement
- Fournit un Dockerfile ou un fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de docker/docs
-
Debian installation pitfallPeut-être pris Une pull request liée à cette issue est ouverte ou déjà fusionnée. Ouvertestatus/triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
Les mainteneurs répondent en général sous 1 jour
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'Peut-être pris @dave123981 l’a pris il y a 1 jour. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
Les mainteneurs répondent en général sous 1 jour
-
status/triage
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
docker/docs#26484 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de docker/docs
Issues similaires
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
w3c/csswg-drafts#14708 ·
Les mainteneurs répondent en général sous 1 jour
-
Keybind quest outdatedOuverteStatus: Triage Type: Quest
Difficulté 2/5 1-3 heures Accessibilité débutants 66/100
GTNewHorizons/GT-New-Horizons-Modpack#27490 ·
Les mainteneurs répondent en général sous 1 jour
-
gebied: infra
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
VincentSmedinga/sc-heerenveen-fansite#538 ·
Les mainteneurs répondent en général sous 1 jour
-
documentation
Difficulté 1/5 1-3 heures Accessibilité débutants 72/100
-
chore docs size:S
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
Les mainteneurs répondent en général sous 1 jour