Người dịch: Tran Ly Vu Người chỉnh sửa: Phuc Cai
Lần đầu tiên bạn làm điều gì đó có thể gặp nhiều trở ngại. Đặc biệt khi bạn đang cộng tác, sai lầm là điều rất khó tránh khỏi. Chúng tôi muốn đơn giản hóa quy trình học và đóng góp vào những dự án mở.
Việc đọc hướng dẫn có tác dụng, nhưng có gì tốt hơn là thực sự đóng góp trong môi trường thực tiễn? Dự án này là nhằm mục đích cung cấp sự hướng dẫn và đơn giản hóa cách thức những người mới tham gia đóng góp. Nếu bạn mong muốn thực hiện việc đóng góp đầu tiên của mình, chỉ cần làm theo các bước đơn giản bên dưới.
Nếu bạn không thích làm việc với dòng lệnh, đây là hướng dẫn sử dụng GUI.
Nếu bạn không có git trên máy tính của bạn, cài đặt
Copy kho mã nguồn này bằng cách nhấn vào nút Fork đầu trang này. Bản sao kho mã nguồn này sẽ được tạo ra trong tài khoản của bạn.
Bây giờ sao chép kho mã nguồn này vào máy của bạn. Nhấn vào nút clone và sau đó nhấn vào biểu tượng copy to clipboard
Mở một bộ xử lý terminal và chạy lệnh git sau đây:
git clone "url bạn vừa sao chép"
Trong đó "url bạn vừa sao chép" (không có dấu ngoặc kép) là url dẫn vào kho mã nguồn này. Xem các bước trước đó để có được url.
Ví dụ:
git clone https://github.com/tên-bạn/first-contributions.git
Trong đó tên-bạn là tên người dùng github của bạn. Ở đây bạn đang sao chép nội dung của kho mã nguồn "first-contributions" trong github vào máy tính của bạn
Thay đổi môi trường làm việc bằng thư mục của kho mã nguồn trên máy tính của bạn.
cd first-contributions
Bây giờ tạo ra một chi nhánh sử dụng lệnh git checkout
git checkout -b <tên-chi-nhánh>
Ví dụ:
git checkout -b thêm-Tran-Ly-Vu
(Tên của chi nhánh không cần phải có từ thêm trong đó, nhưng nó được dùng vì mục đích của chi nhánh này là thêm tên của bạn vào danh sách.)
Bây giờ mở tập tin Contributors.md trong một trình soạn thảo văn bản và thêm tên của mình vào nó.
Đừng thêm vào đầu hoặc cuối tập tin. Thêm vào bất cứ nơi nào ở giữa. Bây giờ, lưu tập tin.
Nếu bạn vào thư mục hiện tại của project và thực hiện lệnh git status, bạn sẽ thấy những thay đổi.
Thêm những thay đổi vào chi nhánh bạn vừa tạo bằng lệnh git add:
git add Contributors.md
Bây giờ chấp nhận những thay đổi bằng cách sử dụng dòng lệnh git commit dưới đây.
git commit -m "Them <ten-ban> vào danh sách Cộng tác viên"
Thay thế <ten-ban> với tên của bạn
Đẩy những thay đổi của bạn sử dụng git push
git push origin <tên-chi-nhánh>
Thay thế <tên-chi-nhánh> với tên của chi nhánh bạn tạo ra trước đó
Nếu bạn mở kho mã nguồn của bạn trên github, bạn sẽ thấy nút Compare & pull request. Nhấp vào nút đó.
Bây giờ gửi yêu cầu kéo.
Tôi sẽ sớm hợp nhất tất cả các thay đổi của bạn vào nhánh chủ (master branch) của project này. Bạn sẽ nhận được email thông báo sau khi các thay đổi đã được hợp nhất.
Chúc mừng! Bạn vừa hoàn thành quy trình tiêu chuẩn copy (fork) -> Sao chép (clone) -> chỉnh sửa (edit) -> yêu cầu kéo (pull request) mà bạn sẽ gặp thường xuyên khi đóng góp!
Hãy ăn mừng đóng góp của bạn và chia sẻ nó với bạn bè và những người theo dõi của bạn bằng cách truy cập ứng dụng web.
Bạn có thể tham gia slack của chúng tôi trong trường hợp bạn cần trợ giúp hoặc có câu hỏi nào. Tham gia slack.
Để hỗ trợ bạn với việc đóng góp cho các project khác. Chúng tôi đã chuẩn bị danh sách các project đơn giản mà bạn có thể bắt đầu. Hãy kiểm tra danh sách các project.
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |