freecodecamp-curriculum 是做什麼的?
貢獻於 freeCodeCamp 開源程式碼庫和課程平台的完整指南。
簡介
freeCodeCamp 是一個由社群驅動的開源專案,旨在幫助人們學習程式設計。其課程平台包含互動式編碼挑戰、認證以及一個大型的貢獻者社群。
先決條件
開始之前,請確保你具備以下條件:
- Git 已安裝並設定
- Node.js (建議使用 LTS 版本)
- npm 或 yarn (套件管理器)
- GitHub 帳號
開發環境設定
- Fork 儲存庫:前往 freeCodeCamp/freeCodeCamp 並點擊「Fork」。
- Clone 你的 Fork:
git clone https://github.com/YOUR_USERNAME/freeCodeCamp.git - 安裝相依套件:
cd freeCodeCamp npm ci - 設定上游儲存庫:
git remote add upstream https://github.com/freeCodeCamp/freeCodeCamp.git
貢獻流程
- 建立分支:從
main分支建立新分支。git checkout -b fix/some-description - 進行變更:編輯課程檔案(位於
curriculum/challenges/)。 - 執行測試:
npm test - 提交變更:
git commit -m "fix: 修正某個挑戰的錯字" - 推送到你的 Fork:
git push origin fix/some-description - 建立 Pull Request:前往 GitHub 並建立 PR。
分支策略
main:穩定分支,僅接受已審查的變更next:預備發行分支- 功能分支:從
main分支建立,用於特定修正或功能
測試
- 單元測試:
npm run test - 課程測試:
npm run test:curriculum - Linting:
npm run lint
最佳實務
- 始終保持分支與
upstream/main同步 - 撰寫清晰且有意義的提交訊息
- 在進行大型變更前,先在 issue 中討論
- 遵循 freeCodeCamp 貢獻指南
故障排除
- 如果遇到相依套件問題,請嘗試刪除
node_modules並重新執行npm ci。 - 確保你使用的是正確的 Node.js 版本(請參閱
.nvmrc或.node-version)。