Cách mở yêu cầu kéo trên GitHub
Yêu cầu kéo (PR) là một tính năng của GitHub cho phép bạn đề xuất các thay đổi đối với kho lưu trữ mà bạn không có quyền ghi. Những người duy trì kho lưu trữ có thể xem lại những thay đổi này và, nếu họ chọn, hợp nhất chúng vào kho lưu trữ ban đầu.
Mở yêu cầu kéo trên GitHub là rất quan trọng trong việc đóng góp cho các dự án nguồn mở và cộng tác với các nhà phát triển khác. Tìm hiểu cách tạo và mở yêu cầu kéo trên GitHub chỉ bằng vài bước đơn giản.
Mục Lục
Bước 1: Forking Kho lưu trữ
Chia nhánh một kho lưu trữ trên nền tảng GitHub sẽ tạo ra một bản sao—còn được gọi là “phân nhánh”—của kho lưu trữ đó, trong tài khoản của bạn. Chuyển đổi một kho lưu trữ cho phép bạn thực hiện các thay đổi đối với mã mà không ảnh hưởng đến kho lưu trữ ban đầu.
Để rẽ nhánh một kho lưu trữ, điều hướng đến trang chính của nó và nhấp vào nút cái nĩa nút ở góc trên cùng bên phải:
Điền vào tên kho lưu trữ (ngã ba) và một mô tả tùy chọn và nhấp vào tạo ngã ba:
Bây giờ bạn đã tạo một bản sao của kho lưu trữ ban đầu. Kho lưu trữ mới này có kết nối với bản gốc để bất kỳ thay đổi nào bạn thực hiện đối với mã có thể dễ dàng so sánh và hợp nhất lại vào đó.
Bước 2: Thực hiện các Thay đổi đối với Mã
Sau khi bạn đã rẽ nhánh kho lưu trữ, bạn có thể cần sao chép nó vào máy cục bộ của mình, tùy thuộc vào số lượng và bản chất của các thay đổi mà bạn muốn đề xuất. Nếu bạn đang thực hiện những thay đổi rất đơn giản mà không cần kiểm tra, bạn có thể thực hiện trực tuyến bằng trình chỉnh sửa dựa trên web GitHub.
Để sao chép kho lưu trữ vào máy cục bộ của bạn bằng Git, hãy chạy lệnh đầu cuối này:
git clone <REPOSITORY_URL>
Thay thế
Bạn nên giữ cho các thay đổi của mình ở mức nhỏ và tập trung, vì các yêu cầu kéo lớn có thể gây khó khăn cho việc xem xét và hợp nhất. Cố gắng giữ các thay đổi của bạn dành riêng cho một vấn đề hoặc tính năng để giúp người bảo trì xem xét và chấp nhận chúng dễ dàng hơn.
Sau khi thực hiện các thay đổi mong muốn của bạn cục bộ, hãy cam kết và đẩy chúng vào ngã ba GitHub của bạn bằng Git.
Bước 3: Mở yêu cầu kéo
Sau khi bạn đã chuyển giao các thay đổi của mình cho GitHub, bạn sẽ thấy lời nhắc cảnh báo rằng nhánh của bạn có một số “cam kết” trước kho lưu trữ mà bạn đã chuyển giao nó từ đó, ví dụ:
Nhấn vào Đóng góp thả xuống. Nhấp vào nút này sẽ nhắc bạn mở yêu cầu kéo. Sau đó, nhấp vào Mở yêu cầu kéo cái nút:
Một số kho lưu trữ có hướng dẫn đóng góp cụ thể mà bạn thường có thể tìm thấy trong tệp CONTRIBUTING.md mà bạn cần tuân theo. Đảm bảo đọc và làm theo các nguyên tắc này trước khi bạn gửi yêu cầu kéo.
Tiếp theo, điền vào các trường bắt buộc và nhấp vào Tạo yêu cầu kéo cái nút:
Thông báo cam kết của bạn phải rõ ràng và ngắn gọn, mô tả những thay đổi bạn đã thực hiện và lý do đằng sau chúng. Điều này sẽ giúp người bảo trì hiểu các thay đổi của bạn và giúp họ xem lại mã dễ dàng hơn.
Khi bạn đã tạo xong pull của mình, bạn sẽ cần đợi những người bảo trì của dự án xem xét và hợp nhất hoặc đóng nó. Người bảo trì có thể có đề xuất hoặc phản hồi về yêu cầu kéo của bạn. Hãy cởi mở với những thay đổi và sẵn sàng sửa đổi nếu họ yêu cầu bạn.
Tầm quan trọng của yêu cầu kéo
Yêu cầu kéo tạo điều kiện cộng tác giữa các nhà phát triển bằng cách cho phép họ đề xuất các thay đổi, cung cấp phản hồi và xem lại mã. Điều này giúp thúc đẩy ý thức cộng đồng và hợp tác trong một dự án, dẫn đến nhiều đóng góp hơn và phát triển nhanh hơn.
Hơn nữa, các yêu cầu kéo tổ chức lịch sử và lập phiên bản của dự án bằng cách cho phép người bảo trì theo dõi các phiên bản khác nhau của mã và các thay đổi được thực hiện cho từng phiên bản.