Github Pull Request 進階操作速查

This content is over 11 years old. It may be obsolete and may not reflect the current opinion of the author.


Github 發 Pull Request 已經幾乎成為貢獻開放原始碼專案的主流操作方法了。Github 的成功就是在於介面設計的相當順手,甚至是如果只是要修改單一檔案可以直接在線上編輯器完成。不過它的流程還是少了最後複雜的部分:在中大型專案,一個 Pull Request 雖然可以留言做 review,但是貢獻者需要一些進階的 git 指令操作能力才能完成 review 來來回回的修改。例如,以下是從 Yuren 那邊偷來的Gaia 在 Github 上面的 workflow:

Gaia Development workflow

因為這樣,我寫了一篇文件以 Pull Request 發出之後,和專案管理者往來會遇到的情境為脈絡,解釋貢獻者該怎麼操作才能順利完成貢獻流程:Github Pull Request 進階操作速查。既然是 Github 上的流程,放 gist 當然是理所當然 … 之後需求的話可以再轉到 repository。

PS: 當初寫的時候沒有搜尋,不過搜尋了才發現還真的沒有人寫過這個流程的中文說明(英文很多就是)。倒是 John Resig 寫了一個 npm package 可以讓專案管理者跳過 Github 的綠色按鈕直接 squash commit:pulley。我比較懶惰,如文章所述,我覺得寫 CONTRIBUTE.md 要求貢獻者照作比較快 😀