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] Confusing guidance about shell workload version compatibility

Đã đóng Phù hợp với người mới
  • Có gì không ổn?
#26,194 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
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
Công nghệ
docker
Lĩnh vực
documentation

Hướng nghiên cứu

Mở content/manuals/ai/sandboxes/customize/author/tool-mixins.md và đọc phần hướng dẫn về phiên bản workload cùng với ví dụ sbx run. Làm rõ sự khác biệt giữa các phím tắt tích hợp sẵn của v2 và shell workload v3 đã được phát hành, sau đó xác minh rằng cách diễn đạt giải thích nhất quán tổ hợp nào được hỗ trợ.

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

Mô tả

File: content/manuals/ai/sandboxes/customize/author/tool-mixins.md

Issue

The tutorial states that built-in shortcuts including shell use v2:

"Use a v3 workload with this mixin. Built-in shortcuts such as shell and claude use v2."

However, the tutorial then immediately uses docker.io/docker/sbx-kit-shell:1.0.0 with the v3 mixin successfully:

$ sbx run docker.io/docker/sbx-kit-shell:1.0.0 --name claude-mixin-test \
    --kit ./claude-mixin
Why this matters

A reader following this tutorial might be confused about whether they can actually use the shell workload with v3 mixins. The statement warns against using shell because it's v2, but then the example uses what appears to be a shell workload. The distinction between the shortcut shell and the full image reference docker.io/docker/sbx-kit-shell:1.0.0 is not explained, leaving readers uncertain whether this combination is actually supported.

Suggested fix

Clarify the distinction between built-in shortcuts (like shell without a registry reference) and published v3 workloads. For example:

"Use a v3 workload with this mixin. Built-in shortcuts such as shell and claude (used without a full image reference) use v2 and can't be combined with v3 mixins. However, Docker provides published v3 workloads like docker.io/docker/sbx-kit-shell:1.0.0 that work with v3 mixins."

Found by nightly documentation quality scanner

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

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.