如何在Github上貢獻一己之力給其他專案?

Adler @ 2015-06-06


如果你對於某個專案有自己的想法,可以嘗試發pull request,讓專案管理員去merge。

這邊用朋友的ngLoading專案當做示範。流程如下:

  1. 將專案Fork一份到自己的帳號底下
  2. 利用各種commit修改專案
  3. 發出pull request,讓對方進行merge

不過首先,你要有Github帳號

1. Fork

首先,找到你要貢獻的專案,點選右上角的fork按鈕:

接著他會出現在你的帳號底下,就可以進去用clone方式複製到自己本機進行修改了。

溫馨小提醒git clone指令:

$ git clone ssh_clone_url

ssh_clone_url是你自己fork過來專案的clone url,如果忘記在哪的話請在瀏覽器中搜尋clone URL就會找到了。

2. Commit

改完code之後進行commit,通常會另開branch,不過如果你夠有把握,也可以直接commit到現有的branch上面。

3. Pull Request

完成以後,到repo頁面,點選右邊的pull request

接著在畫面中間點選create a pull request

接著確認好你目標要merge的commit,以及你自己的commit,如果對方專案很大,這會非常重要。

確認無誤之後,點選大大的綠色按鈕:

接著Github會要求你輸入merge的概要以及細節,以下例子中我只是幫忙在README.md檔案中多加一行空白,所以寫上update README。都完成後一樣點選Create pull request綠色按鈕。

這樣就完成了!期待對方給你通知吧!

4. Merged

如果對方有你的commit意見,會跟你持續討論和修改。如果對方對你的修正滿意,就會進行merge,此時你會收到一封Github寄來的email說明已經merge完成了。

恭喜!這樣就增加了一份對開源專案的貢獻!