[docs-scanner] Outdated Compose v1 reference in dependent-images.md

Geschlossen Anfängerfreundlich
  • Stimmt etwas nicht?
#26,508 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Anfängerfreundlichkeit
85/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
docker, docker-compose, markdown
Bereich
documentation

Rechercherichtung

Der Absatz über Legacy Docker Compose v1 steht in content/manuals/compose/how-tos/dependent-images.md, nahe der Erklärung von additional_contexts. Lies zuerst diesen Abschnitt und formuliere dann den v1-Satz um oder entferne ihn, sodass er die aktuellen parallelen BuildKit-Builds beschreibt. Fertig ist es, wenn die v1-Einordnung verschwunden ist, die Voraussetzung für additional_contexts weiterhin erklärt wird und die Seite in der Docs-Vorschau korrekt gerendert wird.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

File: content/manuals/compose/how-tos/dependent-images.md

Issue

The document references "Legacy Docker Compose v1" in a way that frames it as a recent or relevant comparison point:

Legacy Docker Compose v1 used to build images sequentially, which made this pattern usable
out of the box. Compose v2 uses BuildKit to optimise builds and build images in parallel
and requires an explicit declaration.

Why this matters

This framing creates confusion about:

  1. Current state: Readers may wonder if Compose v1 is still supported or if they need to worry about v1 vs v2 behavior
  2. Relevance: The comparison to v1 behavior suggests this is recent history, when in fact Compose v2 has been the standard for years
  3. Action needed: The text doesn't make it clear that this is purely historical context, not something users need to consider

The document is explaining why additional_contexts is needed, but the v1 reference makes it seem like this is a recent change rather than established behavior.

Suggested fix

Remove or reframe the v1 reference to focus on current behavior:

Option 1 (Remove v1 reference entirely):

Compose uses BuildKit to optimize builds and build images in parallel. When one service's 
Dockerfile uses another service's image as a base, you need to declare this dependency 
explicitly using `additional_contexts`.

Option 2 (Keep as historical note but clarify):

> [!NOTE]
> In older versions of Compose, images were built sequentially, which made this pattern work 
> automatically. Current versions use BuildKit for parallel builds and require an explicit 
> declaration via `additional_contexts`.

Either approach removes the confusing "Legacy Docker Compose v1" framing and focuses on what users need to know: how to make this pattern work today.

Found by nightly documentation quality scanner

Vorherrschende Sprache
Markdown
Sterne
4.7k
Forks
8.5k
Ø Merge
2 T. 14 Std.
Gemergte PRs (30 T.)
129

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus docker/docs

Alle Issues in docker/docs

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.