Cách đóng góp

Chúng tôi rất mong nhận được bản vá và sự đóng góp của bạn cho dự án này. Bạn chỉ cần tuân thủ một số nguyên tắc nhỏ.

Thoả thuận cấp phép cộng tác viên

Nội dung đóng góp cho bất kỳ dự án nào của Google đều phải đi kèm với Thoả thuận cấp phép cộng tác viên. Đây không phải là việc chuyển nhượng bản quyền mà chỉ đơn giản là cho phép Google sử dụng và phân phối lại các nội dung bạn đóng góp trong dự án.

  • Nếu bạn là một cá nhân viết mã nguồn ban đầu và chắc chắn rằng mình sở hữu tài sản trí tuệ, thì bạn cần phải ký một CLA cá nhân.

  • Nếu làm việc cho một công ty muốn cho phép bạn đóng góp công việc của mình, thì bạn cần phải ký thoả thuận cấp phép công ty.

Thường thì bạn chỉ cần gửi CLA một lần. Vì vậy, nếu đã gửi tuyên bố đó (ngay cả khi đó là cho một dự án khác), thì bạn có thể không cần gửi lại.

Gửi bản vá

  1. Nhìn chung, tốt nhất là bạn nên bắt đầu bằng cách mở một vấn đề mới mô tả lỗi hoặc tính năng mà bạn đang định khắc phục. Ngay cả khi bạn cho rằng nội dung đó tương đối nhỏ, thì việc biết được mọi người đang làm gì cũng sẽ rất hữu ích. Trong vấn đề ban đầu, hãy đề cập đến việc bạn dự định xử lý lỗi hoặc tính năng đó để có thể chỉ định cho bạn.

  2. Thực hiện theo quy trình phát hành dự án thông thường và thiết lập một nhánh mới để hoạt động. Điều quan trọng là mỗi nhóm thay đổi phải được thực hiện trong các nhánh riêng biệt để đảm bảo rằng yêu cầu lấy dữ liệu chỉ bao gồm các thay đổi liên quan đến lỗi hoặc tính năng đó.

  3. Mọi thay đổi đáng kể hầu như luôn đi kèm với kiểm thử. Dự án đã có phạm vi kiểm thử tốt, vì vậy, hãy xem một số kiểm thử hiện tại nếu bạn không chắc nên tiến hành như thế nào.

  4. cố gắng hết sức để có thông điệp cam kết đúng định dạng cho mỗi thay đổi. Điều này giúp đảm bảo tính nhất quán trong toàn bộ dự án và đảm bảo rằng các thông báo cam kết có thể được định dạng đúng cách bằng nhiều công cụ git.

  5. Cuối cùng, hãy đưa các thay đổi vào nhánh phát triển của bạn rồi gửi yêu cầu kéo.