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