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

クローズ 初心者向け
  • 何か問題がありますか？
#26,508 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
85/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
docker, docker-compose, markdown
領域
documentation

調査の方向性

Legacy Docker Compose v1 に関する段落は content/manuals/compose/how-tos/dependent-images.md にあり、additional_contexts の説明の近くにあります。まずそのセクションを読み、次に v1 に関する文を、現在の BuildKit による並列ビルドを説明する内容に書き直すか削除してください。v1 の位置づけが消え、additional_contexts の要件の説明が残っており、ドキュメントのプレビューでページが正しく表示されれば完了です。

索引モデルが issue の本文から書いたものです。

説明

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

主要言語
Markdown
スター
4.7k
フォーク
8.5k
平均マージ
2日 14時間
マージ済み PR（30日）
129

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

docker/docs のほかの issue

docker/docs の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。