開始為 Blockly 貢獻內容

Blockly 是開放原始碼，主要由小型團隊維護。我們歡迎核心團隊以外的開發人員提供貢獻；如果沒有社群的協助，我們無法建構所有要求的功能或修正所有回報的錯誤。本節提供一般指南，如果您是初次接觸開放原始碼開發，這些指南或許對您有幫助。

如要瞭解 Blockly 專屬資訊，請參閱「為核心貢獻內容」和「為範例貢獻內容」兩節。

哪個存放區？

存放區包含單一專案的所有檔案。Blockly 有兩個存放區：Blockly 核心和 Blockly-samples。

Blockly 核心是 Blockly 程式庫的存放區。如要對核心 Blockly 行為進行變更，並套用至程式庫的所有使用者，請使用這個存放區。

Blockly 範例是範例、外掛程式和程式碼研究室的存放區。如要建立或修改外掛程式、編寫程式碼研究室，或建立或修改範例，請使用這個存放區。

操作方式

以下是您每次進行變更時，需要遵循的一般步驟。

1. 按照「工具」一節中的連結安裝 Git 和 Node。
2. 建立分支並複製存放區。GitHub 有一個很棒的教學課程，說明如何分支存放區。如要將其套用至 Blockly，請視您要使用的存放區而定，將 octocat/Spoon-Knife 的每個例項都替換為 google/blockly 或 google/blockly-samples。
3. 同步分支版本：GitHub 也提供同步分支的教學課程。
4. 查看主分支版本。在 Blockly 核心中，這是 develop 分支。在 Blockly 範例中，這是 master 分支。
5. 在根目錄中執行 npm install，安裝依附元件和建構工具。
6. 在終端機中執行 git checkout -b myBranchName，建立新分支版本。名稱應能讓您記得正在處理的內容。
7. 進行所需的變更。
8. 按照核心或範例的指南驗證變更。
9. 使用 git commit -am "fix: My commit message" 儲存變更。進一步瞭解提交訊息。
10. 使用 git push origin myBranchName 將變更推送至 GitHub。
11. 準備好程式碼後，請提交合併要求。Blockly 團隊成員會審查您的變更內容，並在核准後將其合併至 Blockly。詳情請參閱PR 審查程序。