Trang này trình bày cách cộng tác viên có thể đề xuất và chỉnh sửa cơ sở mã Bazel.
- Đọc Chính sách đóng góp cho Bazel.
- Tạo một vấn đề trên GitHub để thảo luận về kế hoạch và thiết kế của bạn. Các yêu cầu kéo thay đổi hoặc thêm hành vi cần có một vấn đề tương ứng để theo dõi.
- Nếu bạn đề xuất thay đổi đáng kể, hãy viết một tài liệu thiết kế.
- Đảm bảo bạn đã ký Thoả thuận cấp phép cho người đóng góp.
- Chuẩn bị một thay đổi git triển khai tính năng này. Đừng quên thêm các bài kiểm thử và cập nhật tài liệu. Nếu thay đổi của bạn có tác động mà người dùng có thể nhìn thấy, vui lòng thêm ghi chú phát hành. Nếu đó là thay đổi không tương thích, hãy đọc hướng dẫn triển khai các thay đổi có thể gây lỗi.
- Tạo yêu cầu kéo trên GitHub. Nếu bạn mới sử dụng GitHub, hãy đọc giới thiệu về yêu cầu rút. Xin lưu ý rằng chúng tôi hạn chế quyền tạo nhánh trên kho lưu trữ Bazel chính, vì vậy, bạn sẽ cần đẩy thay đổi của mình vào phần phân nhánh của riêng bạn trong kho lưu trữ.
- Một người duy trì Bazel sẽ chỉ định cho bạn một người đánh giá trong vòng hai ngày làm việc (không bao gồm ngày lễ ở Hoa Kỳ và Đức). Nếu không được chỉ định người đánh giá trong khoảng thời gian đó, bạn có thể yêu cầu người đánh giá bằng cách gửi email đến bazel-discuss@googlegroups.com.
- Làm việc với người đánh giá để hoàn tất quy trình đánh giá mã. Đối với mỗi thay đổi, hãy tạo một thay đổi mới và đẩy thay đổi đó để thực hiện thay đổi đối với yêu cầu của bạn. Nếu quá trình xem xét mất quá nhiều thời gian (ví dụ: nếu người xem xét không phản hồi), hãy gửi email đến bazel-discuss@googlegroups.com.
Sau khi xem xét xong, một người duy trì Bazel sẽ áp dụng bản vá của bạn vào hệ thống kiểm soát phiên bản nội bộ của Google.
Thao tác này sẽ kích hoạt các bước kiểm tra nội bộ trước khi gửi có thể đề xuất thêm các thay đổi. Nếu bạn chưa bày tỏ ý kiến ưu tiên, thì người duy trì gửi thay đổi của bạn sẽ thêm các thay đổi "không đáng kể" (chẳng hạn như tìm lỗi mã nguồn) không ảnh hưởng đến thiết kế. Nếu bạn cần thay đổi sâu hơn hoặc muốn trực tiếp áp dụng các thay đổi, thì bạn và người đánh giá nên nêu rõ lựa chọn ưu tiên trong phần nhận xét của bài đánh giá.
Sau khi gửi nội bộ, bản vá sẽ được xuất dưới dạng một thay đổi Git, tại thời điểm đó, yêu cầu gộp GitHub sẽ được đóng. Tất cả thay đổi cuối cùng đều được phân bổ cho bạn.