Confusing and contradictory information about paths resolving in extend
Maintainer antworten meist innerhalb von 1 Tag
Bewertung
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Anfängerfreundlichkeit
- 72/100
- Issue-Typ
- Dokumentation
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- docker-compose
- Bereich
- documentation
Rechercherichtung
Lies den Block „Important“ und den Abschnitt „Relative paths“ auf der verlinkten Docker Compose-Seite zu extends und prüfe anschließend, welches Verhalten korrekt ist. Aktualisiere die widersprüchlichen Hinweise, damit die Seite durchgehend erklärt, wie Pfade bei der Verwendung von extends aufgelöst werden. Fertig ist die Aufgabe, wenn Leser erkennen können, welche Pfade relativ zur Basis-Compose-Datei sind und wie Pfade im erweiterten Service behandelt werden.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
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.
- Vorherrschende Sprache
- Markdown
- Sterne
- 4.7k
- Forks
- 8.5k
- Ø Merge
- 2 T. 9 Std.
- Gemergte PRs (30 T.)
- 126
Entwicklungsumgebung
- Enthält ein Dockerfile oder eine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus docker/docs
-
FAQ: Docker Desktop Kubernetes stuck on "Starting" behind a corporate proxyEvtl. vergeben Ein verknüpfter Pull Request ist offen oder bereits gemergt. Offenstatus/triage
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
Maintainer antworten meist innerhalb von 1 Tag
-
Debian installation pitfallEvtl. vergeben @Duo-ee hat das vor 2 Tagen übernommen. Offenstatus/triage
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
Maintainer antworten meist innerhalb von 1 Tag
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'Evtl. vergeben @dave123981 hat das vor 3 Tagen übernommen. Offen
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100
Maintainer antworten meist innerhalb von 1 Tag
-
status/triage
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
docker/docs#26484 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
Ähnliche Issues
-
LicenseOffen
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 65/100
-
documentation good first issue
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
ysb3996-blip/oops#51 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100
Maintainer antworten meist innerhalb von 25 Tagen
-
enhancement
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 78/100
-
good first issue
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 82/100
Maintainer antworten meist innerhalb von 1 Tag