Đóng góp cho dự án mã nguồn mở: bắt đầu từ đâu

Đóng góp cho mã nguồn mở là cách học nhanh nhất và cũng là hồ sơ năng lực thuyết phục nhất. Rào cản lớn nhất không phải kỹ thuật, mà là không biết bắt đầu từ đâu.

Đóng góp không chỉ là viết code

  • Sửa lỗi chính tả, làm rõ tài liệu — luôn được hoan nghênh.
  • Dịch giao diện hoặc tài liệu sang tiếng Việt.
  • Báo lỗi kèm các bước tái hiện rõ ràng.
  • Trả lời câu hỏi của người khác trong mục Issues.
  • Viết thêm test cho phần code chưa được kiểm thử.

Nhiều dự án thiếu người viết tài liệu hơn là thiếu lập trình viên.

Tìm việc phù hợp cho người mới

Trên GitHub, lọc theo nhãn:

label:"good first issue"
label:"help wanted"
label:"documentation"

Cách tốt nhất: chọn một thư viện bạn đang thực sự dùng. Bạn đã hiểu nó làm gì, và động lực sẽ bền hơn nhiều.

Quy trình chuẩn

# 1. Fork trên giao diện GitHub, rồi clone bản fork
git clone [email protected]:tenban/duan.git
cd duan

# 2. Thêm remote trỏ về dự án gốc
git remote add upstream https://github.com/goc/duan.git

# 3. Tạo nhánh riêng cho thay đổi
git checkout -b sua-loi-doc-file

# 4. Sửa, chạy test
pytest

# 5. Commit và đẩy lên
git commit -m "docs: sửa ví dụ đọc file trong README"
git push origin sua-loi-doc-file

# 6. Mở Pull Request trên GitHub

Đồng bộ với dự án gốc

git fetch upstream
git checkout main
git merge upstream/main
git push origin main

Trước khi mở PR

  1. Đọc CONTRIBUTING.md — mỗi dự án có quy ước riêng.
  2. Bình luận vào issue báo rằng bạn đang làm, tránh trùng công sức.
  3. Giữ PR nhỏ và chỉ làm một việc. PR sửa 40 file sẽ nằm chờ rất lâu.
  4. Chạy linter và test của dự án trước khi đẩy lên.
  5. Mô tả PR nói rõ: sửa gì, vì sao, đã kiểm thử thế nào.

Khi bị yêu cầu sửa lại

Đây là chuyện bình thường, kể cả với người có kinh nghiệm. Người bảo trì đang giữ chất lượng cho dự án, không phải đang chê bạn. Sửa, đẩy lên nhánh cũ — PR tự cập nhật.

Kỳ vọng đúng mực

Người bảo trì hầu hết làm miễn phí ngoài giờ. PR có thể chờ vài tuần. Một lời nhắc lịch sự sau 2-3 tuần là hợp lý; thúc giục sau hai ngày thì không.

Bắt đầu bằng một PR sửa tài liệu trong tuần này. Cảm giác thấy tên mình trong danh sách người đóng góp của một dự án bạn dùng hằng ngày rất đáng để thử.

Lên đầu trang