VietNetwork.Vn

Bắt đầu hành trình Git của bạn bằng cách chỉnh sửa đơn giản nhất nhờ GitHub.

Bạn có biết rằng bạn có thể đóng góp cho nhiều dự án mã nguồn mở mà không cần phải là chuyên gia về GitHub, Git hay mã hóa không? Cho dù bạn có phải là lập trình viên giàu kinh nghiệm hay không, bạn vẫn có thể học cách sử dụng máy chủ lưu trữ mã nguồn phổ biến nhất thế giới chỉ trong vài bước ngắn.


1. Git là gì và GitHub là gì?

Git là hệ thống kiểm soát phiên bản hàng đầu thế giới. Nó cho phép bạn lưu giữ toàn bộ lịch sử của bất kỳ tệp nào bạn làm việc, cho phép cộng tác và bảo vệ dữ liệu có giá trị của bạn. Bạn có thể xem các tệp tại bất kỳ thời điểm nào trong lịch sử này và sử dụng nhiều tính năng của Git để quản lý mã nguồn của mình—hoặc các loại tệp văn bản khác.

GitHub là một ứng dụng web sử dụng Git để lưu trữ và quản lý hơn 420 triệu kho lưu trữ (repos), thường là các dự án phần mềm nguồn mở. Trang web này bổ sung các tính năng trên Git, bao gồm trình theo dõi lỗi, quản lý tác vụ và wiki. Tuy nhiên, bạn không cần GitHub để sử dụng Git và có nhiều lựa chọn thay thế cho GitHub bao gồm GitLab và Gitea. Tuy nhiên, dự án đầu tiên bạn muốn đóng góp rất có thể sẽ nằm trên GitHub và đó là lý do tại sao chúng tôi trình bày ở đây.


2. Giải thích về Commit và Pull Request

Khi bạn muốn ghi lại những thay đổi của mình vào một tệp do Git kiểm soát, bạn thực hiện một "commit". Một commit có thể biểu diễn những thay đổi vào một tệp hoặc nhiều tệp, và những thay đổi đó có thể lớn hoặc nhỏ tùy theo ý bạn. Nếu cần, bạn có thể khôi phục tệp về bất kỳ commit nào trước đó, vì vậy hãy coi commit như điểm lưu rõ ràng cho dự án của bạn.

Bạn có thể sử dụng Git cho công việc riêng của mình, nhưng sức mạnh thực sự của nó đến từ sự hợp tác. Nếu bạn làm việc trên một dự án với người khác, bạn có thể sử dụng Git để đảm bảo những thay đổi của bạn không xung đột với những thay đổi của đồng nghiệp.

Khi bạn đã thay đổi một dự án, bạn có thể gửi cam kết của mình dưới dạng "yêu cầu kéo ". Điều này cho phép người bảo trì dự án xem xét thay đổi của bạn và nếu được chấp thuận, đưa thay đổi đó vào nguồn chính thức. Phần lớn quá trình này diễn ra tự động, do đó các dự án GitHub có thể chạy hiệu quả, ngay cả khi có hàng trăm người đóng góp thực hiện các thay đổi thường xuyên.

3. Cách thực hiện và gửi bản chỉnh sửa

Git là một công cụ tuyệt vời và rất đáng để tìm hiểu, nhưng nó có đường cong học tập khá dốc. May mắn thay, bạn có thể sử dụng GitHub để bỏ qua điều này và bắt đầu đóng góp cho phần mềm nguồn mở với nỗ lực tối thiểu.

Không thực hiện các cam kết thử nghiệm hoặc yêu cầu kéo trên các dự án trừ khi họ cho phép rõ ràng. Đối với hướng dẫn này, bạn được phép chỉnh sửa tệp   Đăng nhập để xem liên kết trong kho lưu trữ mẫu mà chúng tôi đã tạo.

3.1. Đăng ký với GitHub

Bạn không thể thực hiện chỉnh sửa ẩn danh trên GitHub, nhưng rất dễ để đăng ký và bắt đầu sử dụng trang web. Bạn sẽ cần cung cấp địa chỉ email và xác minh tài khoản của mình:


Sau khi hoàn tất đăng ký, bạn sẽ thấy bảng thông tin cá nhân mà bạn có thể sử dụng để khám phá GitHub và tìm hiểu thêm về dịch vụ:


3.2. Tìm kho lưu trữ

Nhiều dự án có các tệp văn bản đơn giản mà bạn có thể cải thiện bằng cách sử dụng các kỹ năng biên tập và viết cơ bản. Các trang này có thể bao gồm các tệp trợ giúp, nội dung web, v.v. Các dự án thường sẽ đánh giá cao các bản sửa lỗi chính tả và nhiều dự án cần trợ giúp dịch văn bản sang các ngôn ngữ khác.

Một số dự án hầu như hoàn toàn là văn bản đóng vai trò là dữ liệu cho các chương trình khác. Ví dụ, tldr là một công cụ bổ sung cho các trang hướng dẫn và nội dung của nó được quản lý trong kho lưu trữ GitHub.

Trang web của dự án thường có liên kết đến kho lưu trữ GitHub. Tìm liên kết ở góc trên bên phải có nhãn "Fork me on GitHub" hoặc cụm từ như "Find this page on GitHub" cùng với logo "octocat" của GitHub.


3.3. Chỉnh sửa một tập tin

Nếu bạn đã điều hướng trực tiếp đến một tệp, bạn có thể bỏ qua bước đầu tiên này. Nếu không, hãy sử dụng trình duyệt tệp của kho lưu trữ để định vị tệp bạn muốn chỉnh sửa. Nhấp vào tên tệp và bạn sẽ thấy màn hình trông giống như thế này:


Nhấp vào biểu tượng bút chì ở bên phải trang. Khi bạn cố gắng chỉnh sửa một tệp từ kho lưu trữ mà bạn không sở hữu, GitHub sẽ cho bạn biết rằng bạn cần fork tệp đó trước:


Thao tác này sẽ tạo một bản sao (fork) của dự án theo tài khoản của riêng bạn. Sau khi thực hiện thay đổi, bạn sẽ có thể gửi chúng đến chủ sở hữu dự án gốc dưới dạng yêu cầu kéo.

Thực hiện chỉnh sửa bằng trình chỉnh sửa dựa trên trình duyệt của GitHub. Đây là hộp văn bản đơn giản với các tính năng cơ bản bao gồm tô sáng cú pháp. Bạn sẽ không muốn sử dụng nó cho các chỉnh sửa lớn hoặc phức tạp, nhưng nó ổn cho một thay đổi nhanh như lỗi đánh máy hoặc sửa định dạng.


Sau khi bạn đã cập nhật tệp, hãy nhấp vào nút "Commit Changes". Thêm "Extended Description" hữu ích vào hộp văn bản xuất hiện tiếp theo. Bạn không cần phải giải thích chi tiết những gì bạn đã thay đổi, chỉ cần giải thích lý do tại sao bạn thực hiện thay đổi. Hiện tại, hãy giữ nguyên như sau: "Fixed typo" hoặc "Replaceed broken link" là được.

3.4. Mở yêu cầu kéo

Nhấp vào "Đề xuất thay đổi". Thao tác này sẽ đưa bạn đến trang có tiêu đề "So sánh thay đổi" hiển thị thông tin chi tiết về bản cập nhật của bạn. Nhấp vào "Tạo yêu cầu kéo".


Trang tiếp theo lại yêu cầu tiêu đề và mô tả. Vì bạn đang thực hiện một thay đổi duy nhất cho một tệp, nên trang này sẽ tự động điền thông tin chi tiết bạn đã cung cấp trước đó, vì vậy chỉ cần nhấp vào "Tạo yêu cầu kéo" một lần nữa để tiếp tục.

Bạn sẽ đến trang yêu cầu kéo cho kho lưu trữ của dự án gốc.

4. Chuyện gì xảy ra tiếp theo?

Người bảo trì dự án gốc sẽ xem xét thay đổi của bạn. Nếu mọi thứ đều ổn và thay đổi của bạn được chấp nhận, họ sẽ hợp nhất thay đổi từ kho lưu trữ của bạn vào kho lưu trữ của họ. Lúc này, bạn đã đóng góp thành công lần đầu tiên vào một dự án nguồn mở: xin chúc mừng!

Bạn có thể xóa fork của dự án một cách an toàn sau khi yêu cầu kéo được chấp nhận. Nếu bạn có kế hoạch đóng góp thêm trong tương lai, bạn có thể giữ fork, nhưng bạn sẽ cần học cách cập nhật nó khi dự án gốc tiến triển. Cho đến khi bạn cảm thấy thoải mái với Git và GitHub, việc sử dụng quy trình trên và fork dự án mỗi khi bạn cần thực hiện cập nhật sẽ dễ dàng hơn.

Có nhiều loại dự án mà bạn có thể đóng góp mà không cần phải tìm hiểu thêm nhiều về git. Đặc biệt, tính năng GitHub Pages cho phép bạn lưu trữ trang web dự án miễn phí và quản lý trang web đó giống như bất kỳ kho lưu trữ nào khác. Bạn có thể sử dụng biểu tượng Chỉnh sửa để thực hiện các thay đổi cho trang web của mình theo thời gian thực, tất cả đều trong sự thoải mái của trình duyệt web.