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

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#26,508 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
85/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
docker, docker-compose, markdown
Lĩnh vực
documentation

Hướng nghiên cứu

Đoạn văn về Legacy Docker Compose v1 nằm trong content/manuals/compose/how-tos/dependent-images.md, gần phần giải thích additional_contexts. Hãy đọc phần đó trước, rồi viết lại hoặc xóa câu nói về v1 để câu này mô tả các bản build song song hiện tại của BuildKit. Hoàn thành khi không còn khung nội dung về v1, yêu cầu additional_contexts vẫn được giải thích, và trang hiển thị đúng trong bản xem trước tài liệu.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
Markdown
Star
4.7k
Fork
8.5k
Merge trung bình
2 ngày 13 giờ
Pull request đã merge (30 ngày)
141

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của docker/docs

Tất cả issue của docker/docs

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.