Pull Request Là Gì

     

Đóng góp (Contribute) là bề ngoài bạn tham gia đóng góp bằng phương pháp code thêm tính năng, sửa lỗi hay làm cho các vận động liên quan tiền tới một project nuốm thể. Code giỏi sẽ hướng dẫn các bạn cách góp phần lên một dự án trên Github.

Bạn đang xem: Pull request là gì


Github và các mã nguồn mở

Github là 1 trong công ty cung cấp dịch vụ tàng trữ code theo những phiên bản (version control) được giới thiết kế viên ưa thích. Bạn cũng có thể đăng cam kết miễn phí, tập có tác dụng quen với công cụ Git và nhiều hơn thế nữa trên Github.

Github gồm lịch sử nối liền với cộng đồng mã mối cung cấp mở (tức các mã nguồn với những giấy phép cho những người dùng thoải mái và dễ chịu chỉnh sửa và trưng bày lại nó).

Tại sao nên góp sức cho một dự án công trình mã nguồn mở?

Khác với các ứng dụng như Microsoft tốt nhiều doanh nghiệp phát hành, cộng đồng mã mối cung cấp mở vận động và tồn tại bởi chính góp phần của người dùng là lập trình viên, kĩ sư lắp thêm tính, thậm chí còn người dùng thông thường nhưng thân thương và đóng góp.

Hoạt động góp sức thường bao hàm nhiều hình thức. Bạn có thể:

Thông báo lỗi, ý kiến đề nghị tính năng mới, đóng góp đánh giá qua issues.Sửa code và đẩy lên (pull request contribute)

Với các hoạt động này, cộng đồng mã nguồn mở đã có không ít bước phạt triển, phải nói tới sự ra đời của WordPress với trên 30% website được gia công bằng mã mối cung cấp này bên trên mạng mạng internet toàn cầu.

Việc góp sức cũng mang về lợi ích cho cả hai phía:

Người đóng góp đồng thời cũng là người hưởng lợi vày được áp dụng project, tham gia cách tân và phát triển các công dụng mới tương xứng nhu cầu cá thể hoặc tổ chức.Project càng được không ít người nhiệt tình và góp sức thì cường độ ổn định, an toàn và phát triển càng cao.

Bởi vậy, đóng góp góp vào một trong những dự án mã nguồn mở không không giống gì một vận động xã hội mang lại lợi ích cho không hề ít người, chỉ có khác là rứa vì gặp mặt mặt thẳng thì ai đang sử dụng keyboard mà thôi.

Hướng dẫn cách đóng góp bằng code bên trên Github

Bước 1: Tạo tài khoản trên Github


Đầu tiên, bạn cần phải có một tài khoản trên Github. Nó cũng đăng ký dễ dãi và trọn vẹn miễn giá thành tại đây.

Xem thêm: Suburbs Là Gì - Suburban Là Gì

Bước 2: Fork project đã gồm sẵn trên Github

Tiếp đến, bạn truy cập vào project bạn có nhu cầu đóng góp, ví dụ project Oak WordPress Theme do mình đã tạo. Chúng ta nhấp vào nút Fork nghỉ ngơi trên cùng. Thao tác làm việc này sẽ khởi tạo ra một bản sao của project nhưng trên thông tin tài khoản của bạn.


*

Bước 3: lấy code về sản phẩm tính

Sau khi chúng ta đã fork thành công, ta sẽ nên clone project về thiết bị tính. Chúng ta có thể sử dụng HTTPS hoặc SSH (riêng SSH thì yêu cầu bạn tạo key Github đồng hóa nữa) như vào hình:


*

Ta truy vấn vào folder htdocs hoặc www trên máy vi tính và chạy lệnh mặt dưới, sửa chữa thay thế bằng path clone của doanh nghiệp trên project tương ứng:

git clone :khoipro/oak-wordpress-theme

Hoặc


git clonehttps://github.com/khoipro/oak-wordpress-theme.git

Sau đó bạn truy vấn vào thư mục vừa clone, lấy ví dụ như ở đó là vào thư mục /htdocs/oak-wordpress-theme chẳng hạn.

Bước 4: sản xuất branch riêng

Tuỳ theo project mà sản xuất branch tự nhánh masterhay nhánh develop. Thông thường các tính năng lạ sẽ nằm tại nhánh develop, còn nhánh `master chỉ đựng các bản hotfix các lỗi.

Việc tạo ra branch thường thì cần theo quy ước của project đó. độc giả file CONTRIBUTING.md sinh sống ngay trong project để núm được. Nhiều mặt thường vận dụng Git Flow như vậy này, kết hợp với các phiên bạn dạng Code Versioning.

Chẳng hạn, chúng ta có thể tạo các branch ví dụ như sau:

feature/homepagetừ branch developđể update các chức năng hoặc module new cho trang chủ.hotfix/homepagetừ branch masterđể sửa những lỗi đã có trên trang chủ.

Đó là nhị ví dụ phổ biến khi chúng ta tạo branch. Việc này khá đặc trưng vì khi hiển thị lên ở trên project và chế tạo ra pull request, thường thì chủ project cần phải biết ta làm cái gi trên project của họ.

Bước 5: Thêm upstream

Bạn buộc phải thêm upstreamđể nó có thể kết nối cho tới project mình đã fork. Cú pháp ví như sau:

git remote địa chỉ upstreamhttps://github.com/khoipro/oak-wordpress-theme.git

Bước 6: Sửa code và đẩy code lên


Giờ, sau khi bạn đã add xong upstream, checkout branch riêng, hãy sửa code và commit lên như bình thường. Xem xét quan trọng là cách bạn đặt tên phải bảo đảm an toàn theo lý giải tại CONTRIBUTING.md hoặc cần theo quy mong đặt tên commit mà Code giỏi đã phân chia sẻ.

Xem thêm: Độ Nhạy Và Tốc Độ Con Trỏ Trượt Trên Iphone Là Gì Và Cách Điều Chỉnh?

Lấy ví dụ như tôi bao gồm module carousel định sản xuất trang templates Homepage, ta sẽ làm cho như sau:

git địa chỉ template-parts/carousel.php src/scss/modules/carousel.scss/ templates/homepage.phpgit commit -m "Add module Carousel on Homepage"git push -u origin master

Bước 7: sinh sản pull request trên project gốc

Sau khi chúng ta đã chắc chắn mình push code lên thành công, hãy truy cập vào project ban sơ (không phải trong tài khoản của bạn), các bạn sẽ thấy hiện lên:


*

Bạn bấm chuột vào nút Compare và pull request để triển khai tạo pull request. Sẽ sở hữu một mục nhập hiện ra, bạn đa phần mô tả mọi gì mình làm cho và lý do cần làm:


*

Cuối cùng, nhấn vào vào nút Create pull request. Vậy là bạn đã hoàn toàn phần việc của mình.

Tiếp theo, bạn phải chờ sự bình luận từ người chủ sở hữu project, gia nhập hỗ trợ, lý giải để bảo đảm khi merge thì nó vẫn hoạt động. Nếu phần lớn chuyện suôn sẻ, xin chúc mừng, các bạn đã chuẩn bị sẵn sàng tham gia đóng góp vào cộng đồng mã nguồn mở Github!