如何在 GitHub 提交第一個 pull request

什麼是復刻（forking）?

我們可以通過復刻操作將喜愛的倉庫保存自己的 GitHub 賬戶中，以便獨立地對其進行操作。

通過復刻，我們可以得到包含完整版本歷史的目標倉庫的實例，之後可以對復刻得到的倉庫進行任意操作而不會影響到原始倉庫。

拉取請求是爲團隊項目或開源項目做貢獻的一種方式。

例如，一個名爲 Harry forks 的用戶復刻了一個屬於 ThanoshanMV 的倉庫並對其做了一些變更，Harry 可以向 ThanoshanMV 發起一個拉取請求，不過是否接受取決於 ThanoshanMV。這就好像是在說：“ThanoshanMV，你可以拉取我所做的變更嗎？”。

除了編寫代碼，還有許多其他方式可以爲開源項目做貢獻。下面介紹一些可選的貢獻方式。

99xtechnology 資訊科技公司的駭客入門指南爲我們介紹了以下幾種爲開源項目做貢獻的方式：

設計工作：構建整個項目的佈局，提升可用性，提升導航和菜單的用戶體驗，創作項目 logo 和藝術 T 恤，提供樣式指導等。

文檔工作：編寫、完善或者翻譯項目文檔，編寫項目相關的時事通訊，編寫教程，篩選郵件列表中的亮點內容，創建項目使用示例合輯等。

整理工作：鏈接重複的議題，提議新的議題標籤，提議關閉過時的未解決議題，針對近期的議題拋出問題以推動相關討論。

提供幫助：在議題下解答問題，審查他人提交的代碼，爲其他貢獻者提供指導。

編寫代碼：協助解決議題中提及的問題，詢問是否需要自己提供幫助來增加新的功能特性或改進工具和測試流程。

如果你還不太熟悉 Git 和 GitHub, 請查看 The beginner’s guide to Git & GitHub.

點擊頁面頂部的 “fork” 按鈕即可復刻倉庫，這將在你的賬戶中創建此倉庫的完整實例。

$ git clone [HTTPS ADDRESS]

$ cd [NAME OF REPOSITORY]

$ git checkout -b [Branch Name]

$ git add .

$ git commit -m "Adding an article to week 02 of articles of the week"

$ git remote

git push origin [Branch Name]

$ git branch

$ git checkout master

$ git remote add upstream [HTTPS]

$ git fetch upstream

$ git merge upstream/master

$ git push origin master

$ git remote rm [Remote Name]

$ git branch -d [Branch Name]

git push origin --delete [Branch Name]

GitHub 是一個強大的版本歷史控制工具，每一個人都可通過發起拉取請求來爲開源項目做貢獻，而且除了編寫代碼之外還有許多方式可以做出貢獻。

最後要說的是，如果你的拉取請求沒有被接受也不要感到困惑，維護者們花費了大量的時間精力來優化項目，他們比我們更加了解整個項目，所以他們知道如何做出合理選擇。

Stay strong, stay positive, and never give up.
― Roy T. Bennett, The Light in the Heart

文章首發於 Medium。

聯繫作者 Twitter。

請繼續爲開源世界做貢獻！

本文由 Readfog 進行 AMP 轉碼，版權歸原作者所有。
來源：https://chinese.freecodecamp.org/news/how-to-make-your-first-pull-request-on-github/