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