Trong tài liệu này, chúng tôi cung cấp danh sách các quy tắ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 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 hai người duy trì đang hoạt động.
- Bộ quy tắc được ghi nhận đầy đủ, có 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. 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ử để 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 bộ 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 những 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 nhóm chính của Bazel có thể đưa ra quyết định giảm hạng bộ quy tắc.