進行變更

如果您正在考慮讓 Karma 變得更好，或者您只是想修改它，那太好了！以下是一些關於如何設定 Karma 工作區以及如何發送良好的 Pull Request 的技巧。

設定工作區 #

  • 確保您有一個 GitHub 帳戶。
  • 在 GitHub 上Fork 儲存庫。
  • 複製您的 Fork
    $ git clone https://github.com/<your-username>/karma.git
$ cd karma
  • 安裝以進行開發
    $ npm install

測試和建構 #

  • 透過以下方式執行測試

    $ npm test
# or you can run test suits individually
$ npm run test:unit
$ npm run test:e2e
$ npm run test:client

  • 透過以下方式檢查程式碼

    $ npm run lint
# or you can also apply auto-fixes where possible
$ npm run lint:fix

  • 透過以下方式建構客戶端程式碼

    $ npm run build
# or use the watch mode
$ npm run build:watch

變更程式碼 #

簽出一個新的分支，並根據您打算執行的操作為其命名

  • 功能使用前綴 feature-。
  • 錯誤修復使用前綴 fix-。
  • 文件改進使用前綴 docs-。
    $ git checkout -b <branch_name>

開啟您喜歡的編輯器，進行一些更改，執行測試，更改程式碼，執行測試，更改程式碼，執行測試等等。

發送 Pull Request #

  • 提交您的更改（請遵循提交訊息慣例）
    $ git commit -m "..."
  • 確認最後一次提交遵循慣例
    $ npm run commit:check
  • 推送到您的 GitHub 儲存庫
    $ git push origin <branch_name>
  • 前往 GitHub 頁面，然後點擊「開啟 Pull Request」。
  • 撰寫更改的詳細說明。

發送 Pull Request 後，其他開發人員將審查並討論您的更改。請處理所有意見。一切順利後，其中一位維護人員將合併您的更改。

貢獻者授權協議 #

發送 Pull Request 之前，請簽署我們的貢獻者授權協議 (CLA)。若要接受任何程式碼更改，必須簽署 CLA。我們保證這是一個快速的過程！

  • 對於個人，我們有一個簡單的點擊式表單。
  • 對於公司，我們需要您列印、簽署並透過掃描+電子郵件、傳真或郵寄表單。

其他資源 #