如何在GitHub上發出您的第一個拉取請求

如何創建PR以在GitHub上編輯項目?

有許多關於該主題的教程,但是它們通過假設必須做出貢獻而使事情變得過於復雜。代碼到一個項目。所以所有的吉特在此之前進行設置。

如果您只需要編輯文件,也許是項目README來解決打字錯誤,該怎麼辦?

您不需要知道如何編碼或如何使用Git來做到這一點。但是,一旦開始執行“拉取請求”,您就可以做更多的事情,並與其他人協作進行項目!也許這將促使您以後也貢獻代碼。

我假設您已經有一個(免費)的GitHub帳戶。如果不這樣做,請轉到github.com並得到一個。

讓我告訴你這個過程。

我去了這個頁面https://web.dev/prefers-color-scheme/我發現了一個可能的錯字。這條線的末尾缺少一個點。

The article I want to edit

我不是語法納粹,這只是為了尋找一個例子😄

我知道該網站託管在GitHub上,並且確切的文章託管在這裡:https://github.com/GoogleChrome/web.dev/tree/master/src/site/content/en/blog/prefers-color-scheme

The github folder of the article

我打開index.md文件https://github.com/GoogleChrome/web.dev/blob/master/src/site/content/en/blog/prefers-color-scheme/index.md直接在GitHub上,然後按文件工具欄中的鉛筆圖標。懸停它時說:“分叉此項目並編輯文件”。

The index.md file

這將顯示以下信息的編輯器視圖:

您正在編輯一個沒有寫權限的項目中的文件。提交對此文件的更改會將其寫入到分支flaviocopes / web.dev中的新分支中,因此您可以發送拉取請求。

The editor view

我可以添加該點,然後在底部的表單中說明所做的更改:

Propose file change

我按下“建議更改文件”按鈕,然後顯示一個比較視圖。

Compare view

在這裡,我可以查看所做的更改,以確保一切都很好,最後,我可以單擊“創建請求請求”按鈕。目前已對你的叉子的項目,這是由GitHub在單擊鉛筆圖標時自動創建的。

Open pull request

在此視圖的頂部,您可以看到我即將向PR提交PRGoogleChrome/web.dev我表單中的項目flaviocopes/web.dev,來自我的分行patch-2給他們master分支。

按下“創建請求請求”按鈕會顯示另一種形式,我可以在其中編寫請求請求的詳細說明。

拉取請求可以包含許多不同的更改,因此從理論上講,您可以在同一PR中編輯許多文件,這就是為什麼您可以添加摘要的原因。

該存儲庫具有用於PR文本的模板,以幫助團隊對其進行管理。我們的PR非常簡單,因此我刪除了模板,僅粘貼了之前提交消息中的內容。

注意右邊的提示嗎?他們告訴我該項目有一個CONTRIBUTING.md文件,該文件說明瞭如何進行貢獻和指導原則。挺酷的

Contributing

似乎我們需要簽署CLA(貢獻者許可協議)才能完成PR。過去,我已經簽署了Google CLA,因此這一步驟對我來說很明顯,但是您可能需要解決此問題。大多數項目並不真正需要它。

我單擊“創建請求請求”,現在就發送PR!

Pull Request sent

現在由項目維護者介入並接受它,您只需要等待一封電子郵件,告訴您它已被合併,或者其他人有任何評論。

[…過去了幾個小時…]

我收到了一封電子郵件,公關被拒絕了,因為那個點實際上在正確的位置! (我不知道)。

但是無論如何,這是我想補充的一點:如果您接受的PR不被接受,請不要生氣或沮喪。該項目的維護者需要花費數月或數年的時間,並且他們比您更了解什麼對它更好。

另外,尤其是對於代碼,視圖可能會非常不同,並且可能不歡迎您認為很棒的PR。

最好在進行實質性PR之前先詢問,看看這是否是項目真正需要的東西。

但是,這本身就是一個話題。


更多git教程: