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 về Đóng góp cho Bazel.
- Tạo một vấn đề GitHub để thảo luận về kế hoạch và thiết kế của bạn. Các yêu cầu lấy 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 đang đề xuất các thay đổi quan trọng, hãy viết một tài liệu thiết kế.
- Hãy đảm bảo bạn đã ký Thoả thuận cấp phép cộng tác viên.
- Chuẩn bị một git xác nhận để 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ó hiệu ứng mà người dùng có thể 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 một 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ề yêu cầu kéo. 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ẽ phải chuyển cam kết của mình vào bản phát triển nhánh trong kho lưu trữ của riêng bạn.
- Nhân viên bảo trì ở Bazel sẽ giao cho bạn một nhân viên đánh giá trong vòng 2 ngày làm việc (không bao gồm các ngày lễ ở Hoa Kỳ và Đức). Nếu chưa được chỉ định người đánh giá trong khoảng thời gian đó, bạn có thể yêu cầu bằng cách gửi email đến địa chỉ bazel-dev@googlegroups.com.
- Hãy làm việc với người đánh giá để hoàn tất quá trình xem xét mã. Đối với mỗi thay đổi, hãy tạo một cam kết mới và đẩy cam kết đó để thực hiện thay đổi đối với yêu cầu lấy dữ liệu (pull request). Nếu quá trình xem xét mất quá nhiều thời gian (ví dụ: nếu nhân viên đánh giá không phản hồi), hãy gửi email đến bazel-dev@googlegroups.com.
Sau khi quá trình xem xét hoàn tất, một đơn vị bảo trì của Bazel sẽ áp dụng bản vá của bạn cho hệ thống quản lý phiên bản nội bộ của Google.
Thao tác này kích hoạt quy trình kiểm tra trước khi gửi nội bộ có thể đề xuất nhiều thay đổi khác. 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 của bạn sẽ thêm các thay đổi "quan trọng" (chẳng hạn như tìm lỗi mã nguồn) mà 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 cam kết Git, tại thời điểm đó, yêu cầu kéo GitHub sẽ đóng. Mọi thay đổi cuối cùng sẽ được ghi nhận cho bạn.