如何為開源項目做出貢獻

本指南假設基本的命令行和GIT熟悉度提供了有關為開源項目做出貢獻的建議。如果您準備好逐步說明，請前進到“操作方法”部分。

為開源做出貢獻不僅僅是編碼。本指南重點是在GitHub上創建和提交拉動請求（PR）。

入門

您已經找到了一個很棒的GitHub項目，並想貢獻！也許您已經發現了一個錯誤，增強機會或提高代碼可讀性的方法。這是繼續進行的方法：

檢查貢獻指南

許多項目都有CONTRIBUTING.md文件或文檔中的類似貢獻指南。本文檔闡明了：

• 樣式指南
• 公關提交先決條件
• 文檔更新過程
• 貢獻清單
• 項目體系結構和設置

這些指南範圍從簡潔的筆記到廣泛的文件。審查本指南至關重要；它可以節省您和維護者的時間。

查看現有問題和公關

在創建新問題或公關之前，請搜索項目的問題（開放和關閉），以避免重複努力。

提交問題

問題對PR至關重要。他們提供了一個平台來描述問題，添加上下文並促進討論。提交問題時：

• 對於錯誤：指定環境（開發，生產等）。
• 對於功能請求：清楚地說明問題，可能使用用戶故事。
• 對於一般問題：明確說明問題的本質。
• 如果在開始工作之前提供PR：請求許可。

保持尊重的語氣；請記住，維護者自願工作。

發展前的考慮

在開始PR之前：

• 徵求許可：通過問題查詢您的公關的可行性。這樣可以節省時間並防止冗餘工作。
• 使用標籤：將“正在進行的”標籤添加到您的問題中以發出您的作品。
• 小塊工作：提交多個小型PR，專注於個人主題。這簡化了審查並增加了合併的可能性。

提交您的公關

這些步驟概述了公關提交過程：

1. 叉子存儲庫：在您的github帳戶上創建項目的叉子。
2. 本地克隆：克隆您的分叉存儲庫： git clone https://github.com/YOUR-USERNAME/YOUR-FORKED-REPO.git
3. 添加上游：將遙控器添加到原始存儲庫： git fetch upstream git remote add upstream https://github.com/ORIGINAL-DEV-USERNAME/REPO-YOU-FORKED-FROM.git
4. 創建一個分支：創建一個具有描述性名稱的新分支： git checkout -b MEANINGFUL-BRANCH-NAME
5. 進行更改：實施您的更改並使用清晰的消息提交： git add -A ， git commit -m "CLEAR AND CONCISE COMMIT MESSAGE"
6. 推到叉子： git push origin MEANINGFUL-BRANCH-NAME
7. 創建PR： GITHUB將指導您創建PR。鏈接相關問題。在您的公關描述中提供上下文。
8. 保持叉子的更新：從原始存儲庫中拉更改： git pull upstream master

記住要尊重維護者的時間。開源很有意義；貢獻有利於社區和您的學習。感謝克里斯蒂娜·索拉納（Christina Solana）的要旨的靈感。

以上是如何為開源項目做出貢獻的詳細內容。更多資訊請關注PHP中文網其他相關文章！