Add "Supported Distros" column to Features table (and consider adding to spec)

Đang mở
#654 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ó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
45/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
html, json
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với bảng Features tại https://containers.dev/features và các ghi chú triển khai Features tại https://containers.dev/implementors/features/. Sau đó, tìm đặc tả devcontainer-feature.json và xác định thông tin về các distro được hỗ trợ nên được biểu diễn và hiển thị trong bảng như thế nào. Công việc được xem là hoàn tất khi thông tin tương thích được yêu cầu đã được ghi chép nhất quán và thay đổi đặc tả được đưa vào nếu được chấp nhận.

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

Mô tả

I've encountered situations where I want to add a Feature to a devcontainer configuration, only to discover later that it supports only certain distros or package managers. This typically becomes apparent only at build time, leading to wasted effort.

To improve the experience, I'd like to suggest adding a "Supported Distros" column to the Features table at https://containers.dev/features. Displaying this information up front (rather than having it buried in project READMEs) would make it easier to determine whether a Feature can be used with a specific base image or distro, saving time and reducing confusion.

Since the spec already acknowledges this limitation in the docs:

Note: While Features may be installed on top of any base image, the implementation of a Feature might restrict it to a subset of possible base images. For example, some Features may be authored to work with a certain Linux distro (e.g. debian-based images that use the apt package manager).

It might be worth adding a supportedDistros property to the devcontainer-feature.json spec itself. This would improve discoverability, allow the documentation to be auto-generated and ensure distro compatibility is consistently documented across all Features.

Thanks for considering this enhancement!

Ngôn ngữ chính
HTML
Star
207
Fork
435
Merge trung bình
2 ngày 7 giờ
Pull request đã merge (30 ngày)
2

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 devcontainers/devcontainers.github.io

Tất cả issue của devcontainers/devcontainers.github.io

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.