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.

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 thoải mái khi làm việc với dòng lệnh, đây là các hướng dẫn sử dụng các công cụ có giao diện đồ họa (GUI).

Nếu bạn không có git trên máy tính của bạn, cài đặt git.

Rẽ nhánh kho lưu trữ (Fork)

Rẽ nhánh kho lưu trữ mã nguồn (repository) này bằng cách nhấn vào nút Fork trên đầu trang này. Một bản sao kho lưu trữ này sẽ được tạo ra trong tài khoản của bạn.

Tạo bản lưu nội bộ của kho lưu trữ trên máy tính của bạn (clone)

Bây giờ, hãy sao chép, tạo bản lưu nội bộ của kho lưu trữ này vào máy của bạn. Để thực hiện thao tác này, truy xuất vào tài khoản GitHub của bạn, mở kho lưu trữ đã tạo nhánh rồi nhấn vào nút Code, và sau đó nhấn vào biểu tượng copy to clipboard

Mở một cửa sổ 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 lưu trữ mà bạn đã tạo ra trong tài khoản của bạn). 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 (username) tài khoản GitHub của bạn. Ở đây bạn đang sao chép nội dung của kho mã nguồn "first-contributions" trên GitHub vào máy tính của bạn

Tạo nhánh (branch)

Di chuyển đến thư mục chứa kho lưu trữ trên máy tính của bạn (nếu bạn chưa ở đó):

cd first-contributions

Bây giờ tạo ra một nhánh (branch) sử dụng lệnh git switch

git switch -c <tên-nhánh-mới-của-bạn>

Ví dụ:

git switch -c thêm-Tran-Ly-Vu

(Tên của nhánh mới không cần phải có từ thêm trong đó, nhưng nó được dùng vì mục đích của 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 (commit) 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 bạn vào. Đừ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. Sau đó, 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 (trạng thái git), bạn sẽ thấy những thay đổi.

Thêm những thay đổi vào 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> bằng tên của bạn.

Đẩy (push) các thay đổi lên GitHub

Đẩy những thay đổi của bạn sử dụng git push:

git push origin <tên-nhánh-của-bạn>

thay thế <tên-nhánh-của-bạn> với tên của nhánh bạn tạo ra trước đó.

Nếu bạn gặp bất cứ lỗi gì trong lúc thực hiện thao tác push, nhấn vào đây:

Lỗi xác thực (Authentication Error)

remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
fatal: Authentication failed for 'https://github.com//first-contributions.git/'

Truy cập vào GitHub's tutorial về việc tạo cấu hình khóa SSH cho tài khoản của bạn.

Gửi yêu cầu xem xét các thay đổi của bạn

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ấn vào nút đó.

Bây giờ, hãy gửi yêu cầu hợp nhất (pull request)

Tôi sẽ sớm hợp nhất (merge) tất cả các thay đổi của bạn vào nhánh chính (master branch) của dự án này. Bạn sẽ nhận được email thông báo sau khi các thay đổi đã được gộp.

Bước tiếp theo là gì?

Chúc mừng! Bạn vừa hoàn thành quy trình tiêu rẽ nhánh (fork) -> Sao chép (clone) -> chỉnh sửa (edit) -> yêu cầu hợp nhất (pull request) mà bạn sẽ thường gặp khi đóng góp vào những dự án!

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.

Để hỗ trợ bạn với việc đóng góp cho các dự án (project) khác, chúng tôi đã tổng hợp một danh sách các dự án có các vấn đề đơn giản mà bạn có thể bắt đầu. Hãy kiểm tra danh sách dự án trong ứng dụng web.