Quy tắc đề xuất

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Báo cáo vấn đề Xem nguồn

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 nhằm mang lại trải nghiệm tốt cho người dùng. Chúng tôi sẽ 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 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 dưới đây, thì trình bảo vệ quy tắc có thể chỉ định ứng dụng đó thuộc các quy tắc được đề xuất bằng cách gửi vấn đề GitHub.

Sau khi được nhóm cốt lõi Brazil xem xét, trang web đó sẽ được đề xuất trên trang web 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 một số lượng lớn người dùng Bazel (ví dụ: hỗ trợ ngôn ngữ phổ biến rộng rãi).
  • Bộ quy tắc được duy trì tốt. Phải có ít nhất hai trình bảo trì đang hoạt động.
  • Tập hợp quy tắc này được trình bày rõ ràng, 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ó đủ mức độ phù hợp của thử nghiệm.
  • Tập hợp quy tắc này được kiểm thử trên BuildKite với phiên bản mới nhất của Bazel. Kiểm thử phải luôn vượt qua (khi được dùng làm kiểm tra gửi lại).
  • Tập hợp quy tắc cũng được kiểm tra với các thay đổi không tương thích sắp tới. Các sự cố phải được khắc phục trong vòng hai tuần. Các vấn đề về di chuyển cần được báo cáo nhanh chóng cho Nhóm Brazil.

Yêu cầu đối với nhà phát triển Bazel

  • Các quy tắc đề xuất thường được thử nghiệm với 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 một tập hợp cờ mặc định). Nếu có, thay đổi này phải được khắc phục hoặc khôi phục.

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 các yêu cầu, thì bạn nên gửi vấn đề về GitHub.

Chúng tôi sẽ liên hệ với những người duy trì quy tắc và sẽ trả lời trong vòng 2 tuần. Dựa trên kết quả hoạt động, nhóm cốt lõi của Bazel có thể đưa ra quyết định giảm hạng bộ quy tắc.