作者：SHAHED NASSER

如有翻譯不準(zhǔn)確，請多指正。

作為幾個(gè)代碼庫的維護(hù)者，我注意到初學(xué)者在開源過程中會(huì)犯的一些錯(cuò)誤以及可能會(huì)感到困惑的問題。所以，希望我的這篇文章能給到初學(xué)者一些啟發(fā)和幫助。

而代碼庫的存在意義在于幫助初學(xué)者學(xué)習(xí)如何為開源做出貢獻(xiàn)并給他們機(jī)會(huì)。

在我作為維護(hù)者的這段時(shí)間里，我對初學(xué)者的問題和困惑有了一個(gè)了解，所以我想把他整理出來，放在一篇文章中，希望它可以幫助任何想為開源項(xiàng)目做貢獻(xiàn)的初學(xué)者。

01

閱讀貢獻(xiàn)

幾乎在每個(gè)開源存儲(chǔ)庫中，您都會(huì)找到一個(gè)名為 CONTRIBUTING.MD 的文件。該文件將包含對此存儲(chǔ)庫做出貢獻(xiàn)的所有規(guī)則、如何進(jìn)行更改以及如何做出貢獻(xiàn)的指南。閱讀它非常重要，因?yàn)樗梢詾槟愎?jié)省大量時(shí)間來弄清楚你需要做什么，并且可以確保你的拉取請求（或 PR）將遵循項(xiàng)目的所有指南，這將節(jié)省時(shí)間供維護(hù)人員審查并提供要進(jìn)行的更改。

02

創(chuàng)建一個(gè)新的

在為項(xiàng)目做出貢獻(xiàn)時(shí)，您需要做的第一步是分叉它，以便您可以進(jìn)行更改并提交它們。但是很多初學(xué)者錯(cuò)過的一步是您需要?jiǎng)?chuàng)建一個(gè)新分支，不要在分叉后直接對 master 分支進(jìn)行更改，這對維護(hù)者以及整個(gè)項(xiàng)目都非常有幫助。

03

處理問題之前

這在一些開源項(xiàng)目中可能有所不同，但我認(rèn)為它最適用。通常，在為項(xiàng)目做出貢獻(xiàn)時(shí)，您會(huì)轉(zhuǎn)到代碼庫的問題部分以查看需要哪些幫助。當(dāng)你發(fā)現(xiàn)一個(gè)你認(rèn)為可以解決的問題時(shí)，首先確保它是未分配的，然后評(píng)論它并要求分配。許多貢獻(xiàn)者會(huì)忽略問題已分配給其他人的事實(shí)，或者忘記對問題發(fā)表評(píng)論，這會(huì)導(dǎo)致在查看解決同一問題的 PR 時(shí)感到困惑。為避免這種情況，請先對該問題發(fā)表評(píng)論，然后獲得分配，然后提交您的 PR。

?

04

在提交PR之前

?

05

你不需要為每一個(gè)變化

我已經(jīng)看到了很多關(guān)于這個(gè)的困惑。貢獻(xiàn)者會(huì)發(fā)送一個(gè) PR，我會(huì)請求更改，然后貢獻(xiàn)者繼續(xù)關(guān)閉 PR 并提交帶有請求更改的新 PR，但其實(shí)你并不需要這樣做。

當(dāng)你想對 PR 進(jìn)行更改時(shí)，只需進(jìn)行更改，然后將它們提交到您發(fā)送 PR 的存儲(chǔ)庫。假設(shè)您分叉了存儲(chǔ)庫并創(chuàng)建了一個(gè)新分支 patch-1 ，然后在該分支中進(jìn)行更改、提交并推送你的更改。更改將自動(dòng)顯示在 PR 中。

06

不要提交

我收到的 PR 有的會(huì)包含對項(xiàng)目不需要文件的提交，例如你的 IDE 配置文件。但其實(shí)，這些是不必要的。所以你在提交更改之前，請先查看發(fā)生了哪些更改，并且只提交適用于你正在處理的問題的內(nèi)容。

?

07

不要

我最喜歡的貢獻(xiàn)者其實(shí)是那些搞砸了很多事情的人。原因是，因?yàn)樗麄儾粩嗟馗嬖V我他們是新人他們犯了很多錯(cuò)誤，因此我就需要不斷地要求他們改變。老實(shí)說，我認(rèn)為他們會(huì)關(guān)閉 PR 并退出。

但他們沒有，而是不斷地進(jìn)行嘗試，隨著時(shí)間的推移，他們最后不僅提供了所需的結(jié)果，還促成了其他問題的解決。所以，不要害怕犯錯(cuò)，這些錯(cuò)誤只會(huì)成為你成長的臺(tái)階，幫助你取得更多更大地進(jìn)步。

?

08

最后的