Tôi muốn đóng góp cho một dự án nào đó trong GitHub . Tôi có nên ngã ba không? Chi nhánh nào? Những gì được đề nghị và làm thế nào để làm điều đó?

Lý tưởng nhất là bạn:

1. Ngã ba dự án
2. Thực hiện một hoặc nhiều nhận xét tốt và cam kết sạch với kho lưu trữ. Bạn có thể tạo một chi nhánh mới ở đây nếu bạn đang sửa đổi nhiều hơn một phần hoặc tính năng.
3. Thực hiện yêu cầu kéo trong giao diện web của github.

nếu đó là một yêu cầu Tính năng mới, trước tiên đừng bắt đầu mã hóa. Hãy nhớ đăng một vấn đề để thảo luận về tính năng mới.

Nếu tính năng này được thảo luận tốt và có một số +1 hoặc chủ dự án đã phê duyệt nó, hãy chỉ định vấn đề cho chính bạn, sau đó thực hiện các bước trên.

Một số dự án sẽ không sử dụng hệ thống yêu cầu kéo. Kiểm tra với tác giả hoặc danh sách gửi thư về cách tốt nhất để đưa mã của bạn trở lại dự án.

Để thêm vào câu trả lời của Yann , một khi bạn đã rẽ nhánh một dự án, bạn có thể phát triển ở bất kỳ chi nhánh nào bạn muốn (một dự án mới hoặc một từ dự án ban đầu)

Ghi nhớ:

• thêm dự án ban đầu dưới dạng từ xa (hình thức khác ' origin', vì originsẽ là repo của riêng bạn, kết quả của ngã ba)
• rebase chi nhánh của bạn trên đầu chi nhánh của repo ban đầu bạn muốn đóng góp.
  Điều quan trọng là kết quả yêu cầu kéo của bạn trong việc hợp nhất chuyển tiếp nhanh.
  Xem ví dụ:
  • " Kéo các bản cập nhật mới từ kho lưu trữ Github ban đầu vào kho lưu trữ Github rẽ nhánh ".
  • " Cập nhật kho lưu trữ rẽ nhánh trên github "
  • " Git làm việc ngã ba với bản cập nhật "

Để thêm vào câu trả lời của Yan và VonC, đây là một tài nguyên tốt từ chính github: http://help.github.com/forking/

Ngoài ra hãy chắc chắn nhìn vào thanh bên phải dưới tiêu đề "cộng tác".

Có một video Railscast tuyệt vời ở đây hướng dẫn bạn qua quy trình. Nó cũng có một số mẹo hay như chỉ ra cách xác định nhánh nào bạn có thể muốn làm việc khi đóng góp, sử dụng các bài kiểm tra, mô hình con, v.v.

Mặc dù screencast này chủ yếu tập trung vào các nhà phát triển Rails, hầu hết các thông tin đều có giá trị để đóng góp cho bất kỳ dự án nguồn mở nào.

Github có nhiều cách hợp tác với một dự án. Mô hình sử dụng nhiều nhất dự án là một mô hình yêu cầu kéo. Tôi đã bắt đầu một dự án để giúp mọi người thực hiện yêu cầu kéo GitHub đầu tiên của họ. Bạn có thể thực hiện hướng dẫn thực hành để thực hiện PR đầu tiên của mình tại đây

Quy trình làm việc đơn giản như

• Ngã ba repo trong github
• Sao chép repo vào máy của bạn
• Tạo một chi nhánh và thực hiện các thay đổi cần thiết
• Đẩy các thay đổi của bạn lên ngã ba của bạn trên GitHub git push origin branch-name
• Đi đến ngã ba của bạn trên GitHub để xem Compare and pull requestnút
• Click vào nó và cung cấp chi tiết cần thiết

lornajane có một bài đăng trên blog giải thích rõ về quy trình này: http://www.lornajane.net/posts/2010/contribution-to-projects-on-github

Quy trình kỹ thuật

Tôi muốn đề xuất quy trình làm việc sau đây:

1. Ngã ba kho lưu trữ (thông qua giao diện web GitHub: nút "Fork")
2. Trong kho lưu trữ của bạn, sao chép URL

3. Bản sao (trong dòng lệnh)

   git clone <url-from-your-workspace>

4. Nhập thư mục vừa tạo và tạo một nhánh

   cd <directory> git checkout -b <branchname>

5. Bây giờ hãy thay đổi

6. Bạn có thể tạo một hoặc nhiều cam kết sau mỗi thay đổi:

   commit -a

7. Khi hoàn tất, hãy thay đổi

   git push origin <branch>

8. Trong dòng lệnh của bạn, bạn sẽ thấy một URL để tạo PR . Truy cập URL và nhấp vào nút để tạo PR.

9. Nếu không, hãy truy cập kho lưu trữ trong trình duyệt và nó sẽ cung cấp cho bạn một nút để tạo yêu cầu kéo

Đó là nó.

Vì vậy, về cơ bản, bạn đã rẽ nhánh kho lưu trữ vào không gian làm việc của mình, tạo một nhánh mới và đẩy nhánh mới đó.

Nếu sau này bạn thực hiện thêm PR từ cùng một repo nhân bản, bạn nên đồng bộ hóa (nhận các thay đổi mới nhất từ ​​kho lưu trữ ban đầu) trước khi bạn tạo một chi nhánh khác cho PR khác:

git checkout master
git remote add upstream <url-of-original-repo>
git pull upstream master

Những ý kiến ​​khác:

• dự án có thể có Nguyên tắc đóng góp: Tìm kiếm tệp CONTRIBUTING.rst hoặc .md
• bạn có thể muốn làm theo các hướng dẫn mã hóa cho dự án
• bạn có thể muốn phác thảo ý tưởng của bạn như là vấn đề đầu tiên
• bạn có thể muốn xem tab Yêu cầu kéo cho dự án và kiểm tra xem có PR mở, PR hợp nhất không

Những đề xuất này có ở đây để cứu bạn khỏi những rắc rối khi đưa công việc vào PR mà sẽ không được hợp nhất. Nếu có hoạt động trong dự án và PR được hợp nhất, đây là một dấu hiệu tốt. Nếu có Nguyên tắc đóng góp, hãy làm theo chúng.

Luôn luôn lịch sự. Hãy nhớ rằng, những người duy trì dự án không có nghĩa vụ phải hợp nhất PR của bạn. Bạn có một cái gì đó có giá trị để thêm vào dự án?