Quy tắc đề xuất

Báo cáo sự cố Xem nguồn

Trong tài liệu, chúng tôi cung cấp danh sách các quy tắc đề xuất.

Đây là bộ quy tắc có chất lượng cao, sẽ cung cấp trải nghiệm tốt cho người dùng. Chúng tôi phân biệt các quy tắc được hỗ trợ với 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ì trình duy trì quy tắc có thể chỉ định tệp đó làm một phần của các quy tắc đề xuất bằng cách gửi vấn đề về GitHub.

Sau khi được nhóm cốt lõi Bazel đánh giá, ứng dụ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 rộng rãi).
  • Bộ quy tắc được duy trì tốt. Phải có ít nhất 2 nhà bảo trì đang hoạt động.
  • Bộ quy tắc đượ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ó đủ phạm vi kiểm thử.
  • Bộ quy tắc này được kiểm thử trên BuildKite bằng phiên bản mới nhất của Bazel. Các bài kiểm thử phải luôn đạt (khi được sử dụng làm phương thức kiểm tra gửi lại).
  • Bộ quy tắc cũng được thử nghiệm với các thay đổi không tương thích sắp tới. Hệ thống sẽ khắc phục các sự cố lỗi trong vòng 2 tuần. Các sự cố di chuyển phải được báo cáo 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 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 đề xuất (với bộ cờ mặc định). Nếu có, thay đổi sẽ được khắc phục hoặc khôi phục.

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 nữa, 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à cần phản hồi sau 2 tuần. Dựa trên kết quả đạt được, nhóm cốt lõi của Bazel có thể đưa ra quyết định giảm hạng bộ quy tắc.