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 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 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 đó để tham gia các quy tắc được đề xuất bằng cách gửi một Vấ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 2 nhân viên bảo trì đang hoạt động.
- Bộ quy tắc được nêu rõ ràng, kèm theo 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. Bài kiểm thử phải luôn thành công (khi được sử dụng dưới dạng 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 tập hợp mặc định cờ). Nếu điều này xảy ra, thay đổi đó phải được khắc phục hoặc hoàn nguyên.
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 theo yêu cầu của bạn, thì bạn nên đề cập đến một vấn đề trong GitHub. được gửi.
Họ sẽ liên hệ với những người duy trì quy tắc và họ cần trả lờ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.