Nó khó. Lần đầu tiên bạn làm điều gì đó thật khó khăn. Đặc biệt khi bạn đang cộng tác, những sai lầm không phải là điều thoải mái. Nhưng mã nguồn mở là tất cả về sự hợp tác và làm việc cùng nhau. Chúng tôi muốn đơn giản hóa cách những người đóng góp lần đầu tiên mới học và đóng góp.
Đọc hướng dẫn có thể giúp, nhưng tốt nhất là thực sự đóng góp mà không làm rối tung bất cứ điều gì. Dự án này nhằm mục đích cung cấp hướng dẫn và đơn giản hóa cách thức những người tân binh tham gia đóng góp lần đầu tiên. Hãy nhớ rằng khi bạn cảm thấy thoải mái thì việc học sẽ trở nên dễ dàng hơn. Nếu bạn mong muốn thực hiện việc đóng góp đầu tiên của mình, bạn chỉ cần làm theo các bước đơn giản bên dưới. Chúng tôi hứa bạn sẽ có nhiều niềm vui.
Đọc bản hướng dẵn này bằng các ngôn ngữ khác: Tiếng Tây Ban Nha, Tiếng Hà Lan, Tiếng Hindi, Tiếng Nga, Tiếng Nhật, Tiếng Anh, Tiếng Ba Lan, Tiếng Hàn Quốc, Tiếng Đức, Tiếng Trung giản thể, Tiếng Trung truyền thống, Tiếng Hy Lạp.
Nếu bạn không thích làm việc với dòng lệnh, hãy thử hướng dẫn của chúng tôi dựa trên GitKraken.
Nếu bạn không có git trên máy tính của bạn, cài đặt nó
Fork 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 mà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/this-is-you/first-contributions.git
Trong đó 'this-is-you' 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 <them-ten-ban>
Ví dụ:
git checkout -b them-Tran-Ly-Vu
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ó, sau đó lưu tập tin. Nếu bạn đi đến thư mục dự án và nhập lệnh git status, bạn sẽ thấy có những thay đổi. Thêm những thay đổi bằng cách nhập dòng lệnh dưới đây '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 <them-ten-ban>
Thay thế <them-ten-ban> 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.
Bây giờ tôi sẽ kết hợp tất cả các thay đổi của bạn vào chi nhánh chủ (master branch) của dự án này. Bạn sẽ nhận được một email thông báo khi những thay đổi đã được sáp nhập.
Chi nhánh chủ của fork của bạn sẽ không có những thay đổi. Để giữ cho khớp của bạn được đồng bộ với chi nhánh chủ của tôi, hãy làm theo các bước dưới đây.
Đầu tiên, chuyển sang chi nhánh chủ.
git checkout master
Sau đó, thêm url repo của tôi như sau upstream remote url.
git remote add upstream https://github.com/multunus/first-contributions
Đây là một cách để nói với git rằng một phiên bản khác của dự án này đang tồn tại trong một url khác và chúng ta gọi đó là phiên bản chủ. Một khi các thay đổi được sáp nhập, kéo phiên bản mới này đang nằm trong kho mã nguồn của tôi.
git fetch upstream
Ở đây chúng ta lấy tất cả những thay đổi trong fork của tôi (upstream remote). Bây giờ, bạn cần phải hợp nhất các phiên bản mới của kho mã nguồn của tôi vào chi nhánh chủ (master) của bạn.
git rebase upstream/master
Ở đây bạn đang áp dụng tất cả những thay đổi bạn lấy để đưa vào chi nhánh chủ (master). Nếu bạn đẩy chi nhánh chủ bây giờ, bản sao của bạn cũng sẽ có những thay đổi
git push origin master
Chú ý ở đây bạn đang đẩy lên trên github với chi nhánh tên là origin.
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |
Dưới đây là một số vấn đề cho người bắt đầu trong các kho mã nguồn phổ biến mà bạn có thể tham gia đóng góp. Nhấn vào những kho mã nguồn này để tìm hiểu thêm
