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