開始為 Blockly 貢獻內容

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

如要瞭解 Blockly 的特定資訊，請先參閱「為核心貢獻內容」和「為範例貢獻內容」一節，再進行貢獻。

請問是哪一個存放區？

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

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

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

操作方式

每次變更時，您都會按照這些一般步驟操作。

1. 按照「工具」部分中的連結，安裝 Git 和 Node。
2. 建立存放區分支並加以複製。GitHub 提供存放區分叉的絕佳教學課程。如要套用至 Blockly，只要將每個 octocat/Spoon-Knife 執行個體取代為 RaspberryPiFoundation/blockly 或 RaspberryPiFoundation/blockly-samples，視您要使用的存放區而定。
3. 同步處理分叉。GitHub 也提供同步處理 Fork 的教學課程。
4. 查看主要分支版本。在 Blockly 核心中，這是 develop 分支。在 blockly-samples 中，這是 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 Review Process」。