README.vn.md

Người dịch: Tran Ly Vu Người chỉnh sửa: Phuc Cai

Những đóng góp đầu tiên

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 (Fork)

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.

Sao chép kho mã nguồn (clone)

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

Tạo chi nhánh (branch)

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.)

Thực hiện những thay đổi cần thiết và chấp nhận những thay đổi này

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 thay đổi lên github

Đẩ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 đó

Gửi những thay đổi của bạn để xem xét

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.

Tiếp theo

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.

Tài liệu bổ sung

Hướng dẫn sử dụng các công cụ khác

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA