Trong tài liệu, 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 mà 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 đó vào các quy tắc được đề xuất bằng cách báo cáo vấn đề trên GitHub.
Sau khi được nhóm nòng cốt của Bazel xem xét, đề xuất này sẽ được đăng trên trang web Bazel.
Yêu cầu đối với người duy trì quy tắc
- Nhóm 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 2 người duy trì đang hoạt động.
- Bộ quy tắc này được ghi lại đầy đủ, có ví dụ và dễ sử dụng.
- Nhóm quy tắc 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ử.
- Bộ quy tắc được kiểm thử trên BuildKite bằng phiên bản Bazel mới nhất. Các kiểm thử phải luôn thành công (khi được dùng làm quy trình kiểm tra trước khi gửi).
- Bộ quy tắc cũng được kiểm thử với những thay đổi không tương thích sắp tới. Các lỗi này phải được khắc phục trong vòng 2 tuần. Bạn nên nhanh chóng báo cáo các vấn đề về việc 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 đượ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ỡ một quy tắc được đề xuất (với bộ cờ mặc định). Nếu điều này xảy ra, bạn nên khắc phục hoặc khôi phục 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, bạn nên 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ải phản hồi trong vòng 2 tuần. Dựa trên kết quả, nhóm nòng cốt của Bazel có thể đưa ra quyết định hạ cấp bộ quy tắc.