Đây là một bộ quy tắc chất lượng cao, sẽ mang lại trải nghiệm tốt cho
người dùng. Chúng tôi tạo ra sự khác biệt giữa các quy tắc được hỗ trợ và hàng trăm
quy tắc bạn có thể tìm thấy trên Internet.
Đề cử
Nếu một bộ quy tắc đáp ứng các yêu cầu bên dưới, thì người duy trì quy tắc có thể đề cử bộ quy tắc đó
để tham gia các quy tắc được đề xuất bằng cách gửi một
Vấn đề GitHub.
Sau khi nhóm cốt lõi Bazel xem xét,
sẽ được đề xuất trên trang web của Bazel.
Yêu cầu đối với người duy trì quy tắc
Bộ quy tắc cung cấp một tính năng quan trọng, hữu ích cho rất nhiều Bazel
người dùng (ví dụ: hỗ trợ cho một ngôn ngữ phổ biến).
Bộ quy tắc được duy trì tốt. Phải có ít nhất 2 nhân viên bảo trì đang hoạt động.
Bộ quy tắc được nêu rõ ràng, kèm theo ví dụ và dễ sử dụng.
Bộ quy tắc này tuân thủ các phương pháp hay nhất và mang lại hiệu quả cao (xem
hướng dẫn về hiệu suất).
Bộ quy tắc có đủ phạm vi kiểm thử.
Bộ quy tắc được kiểm tra vào
BuildKite
bằng phiên bản Bazel mới nhất. Bài kiểm thử phải luôn thành công (khi được sử dụng dưới dạng
kiểm tra trước khi gửi).
Bộ quy tắc này cũng được kiểm thử để dự đoán những thay đổi sắp tới không tương thích. Vết vỡ
sẽ được khắc phục trong vòng hai tuần. Bạn cần báo cáo các vấn đề về di chuyển cho
Bazel lên án nhanh chóng.
Các yêu cầu dành cho nhà phát triển Bazel
Các quy tắc đề xuất thường xuyên được thử nghiệm với Bazel ở phần đầu (ít nhất một lần
ngày).
Không có thay đổi nào trong Bazel có thể phá vỡ quy tắc được đề xuất (với tập hợp mặc định
cờ). Nếu điều này xảy ra, thay đổi đó phải được khắc phục hoặc hoàn nguyên.
Giảm hạng
Nếu lo ngại rằng một bộ quy tắc cụ thể không còn đáp ứng
theo yêu cầu của bạn, thì bạn nên đề cập đến một vấn đề trong GitHub.
được gửi.
Họ sẽ liên hệ với những người duy trì quy tắc và họ cần trả lời trong vòng 2 tuần. Dựa trên
nhóm chính của Bazel có thể đưa ra quyết định giảm hạng bộ quy tắc.