譯文:初學(xué)者必看的開源技巧

我是法醫(yī),一只治療系前端碼猿??,與代碼對話,傾聽它們心底的呼聲,期待著大家的點(diǎn)贊??與關(guān)注?,當(dāng)然也歡迎加入前端獵手技術(shù)交流群??,文末掃碼我拉你進(jìn)群,一起交流技術(shù)以及代碼之外的一切???♀?
轉(zhuǎn)載自Duing(ID:duyi-duing)
作者: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
最后的
RECOMMEND
? ?
很感謝小伙伴看到最后??,如果您覺得這篇文章有幫助到您的的話不妨關(guān)注?+點(diǎn)贊??+收藏??+評(píng)論??,您的支持就是我更新的最大動(dòng)力。
歡迎加入前端獵手技術(shù)交流群??,文末掃碼加我微信,我拉你進(jìn)群,一起交流技術(shù)以及代碼之外的一切???♀?
