Trang này trình bày cách người đóng góp có thể đề xuất và chỉnh sửa Bazel cơ sở mã.
- Đọ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 kéo làm thay đổi hoặc thêm hành vi cần có 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 tài liệu thiết kế.
- Đảm bảo bạn đã ký Giấy phép cộng tác viên Thoả thuậ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 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 về cách triển khai những thay đổi có thể gây lỗi.
- Tạo yêu cầu lấy dữ liệu trên GitHub. Nếu mới sử dụng GitHub, đọc giới thiệu về chế độ lấy dữ liệu . 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 thực hiện cam kết của mình đối với nhánh phát triển của riêng bạn kho lưu trữ.
- Nhân viên bảo trì tại Bazel sẽ giao cho bạn một nhân viên đánh giá trong vòng 2 ngày làm việc (ngoại trừ các ngày lễ ở Hoa Kỳ và Đức). Nếu bạn không được chỉ định trong thời gian đó, bạn có thể yêu cầu người đánh giá bằng cách gửi email 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 xác nhận mới và đẩy nó để thực hiện thay đổi đối với yêu cầu lấy dữ liệu (pull request). Nếu bài đánh giá 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 quá trình xem xét hoàn tất, một nhân viên 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ể gợi ý thêm thay đổi. Nếu bạn chưa thể hiện lựa chọn ưu tiên, thì việc gửi thay đổi của bạn thêm "quan trọng" các thay đổi (chẳng hạn như tìm lỗi mã nguồn) mà không ảnh hưởng thiết kế của bạn. Nếu cần phải thay đổi sâu hơn hoặc bạn muốn đăng ký thay đổi trực tiếp, bạn và người đánh giá phải truyền đạt các lựa chọn ưu tiên rõ ràng trong nhận xét đánh giá.
Sau khi gửi nội bộ, bản vá sẽ được xuất dưới dạng một bản cam kết Git, lúc đó, yêu cầu lấy dữ liệu GitHub sẽ đóng. Tất cả thay đổi cuối cùng được ghi nhận cho bạn.