Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[docs-scanner] Contradictory information about Docker Engine 29.0 default storage

Đang mở Phù hợp với người mới
#26,163 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

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
90/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
Lĩnh vực
documentation

Hướng nghiên cứu

Issue này chỉ ra ba tệp Markdown cụ thể trong thư mục content/manuals/engine/storage/drivers/. Hãy bắt đầu bằng cách đọc các tệp này để hiểu các tuyên bố mâu thuẫn về bộ lưu trữ mặc định của Docker Engine 29.0. Bản sửa lỗi là chuẩn hóa ngôn ngữ, thêm cụm từ bổ nghĩa 'cho các cài đặt mới' vào overlayfs-driver.md và đảm bảo tính nhất quán. Kiểm tra các thay đổi bằng cách xem bản xem trước cục bộ của 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ả

Files:

  • content/manuals/engine/storage/drivers/_index.md
  • content/manuals/engine/storage/drivers/select-storage-driver.md
  • content/manuals/engine/storage/drivers/overlayfs-driver.md
Issue

Multiple files in the storage drivers section present contradictory information about what Docker Engine 29.0 uses by default. The index file says:

Docker Engine 29.0 and later uses the containerd image store by default for fresh installations, which uses snapshotters instead of classic storage drivers.

But select-storage-driver.md says:

Docker Engine 29.0 and later uses the containerd image store by default for fresh installations.

And overlayfs-driver.md says:

Docker Engine 29.0 and later uses the containerd image store by default. The overlay2 driver is a legacy storage driver that is superseded by the overlayfs containerd snapshotter.

The contradiction is: Does Docker Engine 29.0 use containerd image store "by default" (implying always), or only "by default for fresh installations" (implying upgrades use something else)? The index and select-storage-driver pages say "for fresh installations" but overlayfs-driver doesn't include this qualifier.

Why this matters

A reader trying to understand whether their Docker Engine 29.0 installation uses containerd image store or classic storage drivers will get conflicting answers depending on which page they read. This is especially confusing for users who upgraded from an earlier version versus those who did a fresh install.

Suggested fix

Standardize the language across all three files. The most accurate framing appears to be: "Docker Engine 29.0 and later uses the containerd image store by default for fresh installations. If you upgraded from an earlier version, your daemon continues using classic storage drivers unless you migrate."

Apply this consistent language to all three files, particularly updating overlayfs-driver.md to include the "fresh installations" qualifier.


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 18 giờ
Pull request đã merge (30 ngày)
121

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

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.